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Debugging C Programs for 
6833x7340/360 Microprocessors 



The HP B1473B 6833x7340/360 Debugger/Emulator is a debugging tool for 6833x 
(68331, 68332 and so on), 68340, and 68360 microprocessor code. The debugger 
loads and executes C programs or assembly language programs on HP 64749, 
HP 64751, HP 64780, or HP 64782 emulators. The debugger also supports the 
HP 3490A HP Software Probe and some ROM monitors. The code is executed in 
real time unless a specific feature of the debugger or emulator requires halting the 
processor. The emulator functions as a high-speed execution enviroimient for the 
debugger. 

With the Debugger, You Can ... 

• Browse and edit C and C++ source files. 

• View C and C++ functions on the stack. 

• Monitor variables as the program executes. 

• View assembly language code with source lines. 

• View registers and stack contents. 

• Step through programs by C or C++ source lines or by assembly language 
instructions. 

• Stop programs upon the execution of selected instructions or upon a read or 
write of selected memory locations. 

• Create conditional breakpoints using macros. 

• Patch C or C++ code without recompiling. 

• Collect microprocessor bus-level data as the program executes. You can 
specify when data should be collected and which states get saved. (Bus-level 
trace data is available only if you are using an emulator.) 

• Simulate input and output devices using your computer's keyboard, display, 
and file system. 

• Save and execute command files. 

• Log debugger commands and output. 

• Examine the inheritance relationships of C++ classes. 

• Use the debugger, the emulator/analyzer, and the Software Performance 
Analyzer together. 



With the Graphical Interface You Can . 



• Use the debugger under an X Window System that supports OSF/Motif 
interfaces. 

• Enter debugger commands using pull-down or pop-up menus. 

• Set source-level breakpoints using the mouse. 

• Create custom action keys for commonly used debugger commands or 
command files. 

• View source code, monitored data, registers, stack contents, and backtrace 
information in separate windows on the debugger's main display. 

• Access on-line help information. 

• Quickly enter commands using the guided syntax of the standard interface. 

With the Standard Interface You Can ... 

• Use the debugger with a terminal or terminal emulator. 

• Quickly enter commands using guided syntax, command recall, and command 
editing. 

• View source code, monitored data, registers, stack contents, and backtrace 
information in separate windows on the debugger's main display. 

• Define your own screens and windows in the debugger's main display. 

• Access on-line help information. 

Compatibility with Other Products 

The debugger/emulator has been designed to work with HP-UX (version 8.0 or 
greater), SunOS, or Solaris (see the Installation Notice for version requirements) 
and the following Hewlett-Packard language products: 

HP B3640, Motorola 68000 Family C Cross Compiler, Version 4.00 

HP B3641, Motorola 68000 Family Assembler, Linker, Librarian, 
Version 2.00. 

HP B1471, HP 64000-UX Operating Environment Software, Version 6.20. 

See the "Loading and Executing Programs" chapter if you are using the Microtec 
language tools. 
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In This Book 



This book is organized into five parts: 

Part 1. Quick Start Guide 

An overview of the debugger and a short lesson to get you started. 

Part 2. User's Guide 

How to use the debugger to solve your problems. 

Part 3. Concept Guide 

Background information on X resources. 

Part 4. Reference 

Descriptions of what each debugger command does, details of how the debugger 
works, and a hst of error messages. 

Part 5. Installation 

How to install the debugger software on your computer. 
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Getting Started with the Graphical 
Interface 

How to get started using the debugger' s graphical interface. 



Chapter 1 : Getting Started with the Graphical Interface 

When an X Window System that supports OSF/Motif interfaces is running on the 
host computer, the debugger has a graphical interface that provides features such 
as pull-down and pop-up menus, point and click setting of breakpoints, cut and 
paste, on-line help, customizable action keys and pop-up recall buffers. 

The debugger also has a standard interface for several types of terminals, terminal 
emulators, and bitmapped displays. When using the standard interface, commands 
are entered from the keyboard. You should use the graphical interface for the 
exercises in this chapter. 

Some advanced commands are not well-suited to menus. Those commands are 
entered through the command line. The command line allows you to enter standard 
interface commands in the graphical interface. 
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The Graphical Interface at a Glance 
Pointer and cursor sliapes 

1^ Arrow 



1 



The arrow mouse pointer shows where the mouse is pointing. 
Hand 

The hand mouse pointer indicates that a pop-up menu is available by pressing the 
right mouse button. 

Hourglass 

The hourglass mouse pointer means "wait." If the debugger is busy executing a 
program, you may stop it by pressing <Ctrl>-C. 



I Text 

The "I-beam" keyboard cursor shows where text entered with the keyboard will 
appear in the entry buffer or in a dialog box. 

I I Command-line 

The "box" keyboard cursor on the command Une shows where commands entered 
with the keyboard will appear. 



5 



Chapter 1 : Getting Started with the Graphical Interface 

The Debugger Window 



Menu bar 
Action keys 
Entry buffer 

Scroll bar 
Display area 



Fi 


c Dispkiy 


hvlodify ExccLition Bi'c:ikpoint5 VVindov/ 


Settings 






Help 


Action keys: 


< Demo > II Disp Src ( ) || Disp Src PC || 


Run 


II Run Til 0 1 


Run Xfer 




|< Your Key >| 


Make || CExpr() jj Monitor () || 


Step 


II Step Over | 


Step Out 


1 


(): 


main 










1 Recall 




Status line 




STATUS: Command 68348 


MODULE: crte BREAK »: 2 TRC:Idle ^ 1 ^ 1 




> 




/ 


^^^^1 |Debugger| |Expressior 


ijjFi lej jHenoryj |Progm| |Syabol | |Hindoii| |Trace| 




\ 


Access Instr Read Mrite 


Clear_All Delete 


Command line 


Command: |Return||Recall| 


Cursor: |Backup||Forward||Clearto end||Clear| |Help| 
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Menu Bar. Provides pull-down menus from which you select commands. When 
menu items are not appUcable, they appear half-bright and do not respond to mouse 
clicks. 

Action Keys. User-defined pushbuttons. You can label these pushbuttons and 
define the action to be performed. Action key labels and functions are defined by 
setting X resources (see the "Configuring the Debugger" chapter). 

Entry Buffer. Wherever you see "()" in a puU-down menu, the contents of the 
entry buffer are used in that command. You can type values into the entry buffer, or 

you can cut and paste values into the entry buffer from the display area or from the 
command line entry area. You can also set up action keys to use the contents of the 
entry buffer. 

Display Area. This area of the screen is divided into windows which display 
information such as high-level code, simulated input and output, and breakpoints. 
To activate a window, click on its border. 

In this manual, the word "window" usually refers to a window inside the debugger 
display area. 

Scroll Bar. Allows you to page or scroU up or down the information in the active 
window. 

Status Line. Displays the debugger and emulator status, the CPU type, the 
current program module, the trace status, and the number of the last breakpoint. 

Command Line. The command line area is similar to the command line in the 
standard interface; however, the graphical interface lets you use the mouse to enter 
and edit commands. You can turn off the command line if you only need to use the 
puU-dovm menus. 
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Graphical Interface Conventions 

This manual uses a shorthand notation for indicating that you should choose a 
particular menu item. For example, the following instruction 

Choose File^Load^Executable... 

means to select the FUe menu, then select Load from the File menu, then select the 
Executable... item from the Load menu. 



File 




Context > 




Load > 


Emulator Config ... 


Store > 


Executable ... ^ 


Copy Window > 


Program Only ... 


Log > 


Symbols Only ... 


Emul700 > 


User-Defined Macros... 


Edit > 




Term ... 




Exit > 





Refer to the "Entering Debugger Commands" for specific information about 
choosing menu items. 

In this manual, the word "window" usually means a window inside the debugger 
display area, rather than an X window. 
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Mouse Buttons 



Mouse Buttons 



Mouse Button Descriptions 



Button Name 

left 

middle 
right 

command select 



General Function 

Selects pushbuttons. Pastes from the display area to 
the entry buffer. 

Pastes from the entry buffer to the command Une text 
area. If you have a two-button mouse, press both 
buttons together to get the "middle button." 

Click selects first item in pop-up menus. Chck on 
window border activates windows. Press and hold 
displays menus. 

Displays pull-down menus. May be the left button or 
right button, depending on the kind of computer you 
have. See "Platform Differences" on page 10. 
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Platform Differences 

A few mouse buttons and keyboard keys work differently between platforms. This 
manual refers to those mouse button and keyboard bindings in a general way. 
Refer to the following tables to find out the button names for the computer you are 
using to run the debugger. 



Mouse Button Bindings 



Generic Button Name HP 9000 Sun SPARCsystem 

command select left right 



Keyboard Key Bindings 



Generic Key Name 


HP 9000 


Sun SPARCsystem 


menu select 


extend char 


extend char 






(diamond) 


left- arrow 


left arrow 


left arrow ^ 


right- arrow 


right arrow 


right arrow ^ 



These keys do not work while the cursor is in the main display area. 
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Platform Differences 



The Quick Start Tutorial 

This tutorial gives you step-by-step instructions on how to perform a few basic 
tasks using the debugger. 

Perform the tasks in the sequence given; otherwise, your results may not be the 
same as those shown here. 

Some values displayed on your screen may vary from the values shown here. The 
exercises in this chapter use a HP 6475 1 68340 emulator. If you are using another 
emulator, the information displayed in some windows on your screen will be 
different. 

The Demonstration Program 

The demonstration program used in this chapter is a simple environmental control 
system (ECS). The system controls the temperature and humidity of a room 
requiring accurate envirormiental control. The program continuously looks at flags 
which tell it what action to take next. 



Note Some commands are printed on two lines in this chapter. When entering these 
commands, type the entire command on one Une. 
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To prepare to run the debugger 

1 Check that the debugger has been installed on your computer. Installation is 
described in the "Installation" chapter. 

2 Find the logical name of your emulator. 

The emulator name emul68k is used in the examples in this chapter. If you have 
given your emulator a different logical name in the HP 64700 emulator device table 
/usr/hp64000/etc/64700tab.net, use your emulator name or Ian address in the 
examples. See the section 'To find the logical name of your emulator" in the 
"Installation" chapter of this manual. See the HP 64700A Card Cage 
Installation/Service Manual for detailed information on installing your emulator. 

The HP 64749G emulator and the HP Software Probe have no emulation memory 
and must be connected to a target system before use. The demo requires that the 
target system have at least 64 Kbytes of target RAM in the first 64 Kbytes of 
addressable space, and that the processor is set up to select the memory. You must 
execute some code to set up the SIM registers for your target system, or set them 
up using the debugger. If you do not have 64 Kbytes of TARGET RAM starting at 
address 0, then please modify the linkcom_A.k file and rebuild to locate the 
program at a suitable location in memory. 

The HP 64751, HP 64749H, HP 64749J, HP 64780, and HP 64782 emulators have 
built-in emulation memory, so you may run the demo without a target system. 

3 Find out where the debugger software is installed. If it is not installed under 
"/usr/hp64000" then use "$HP64000" wherever "/usr/hp64000" is printed in this 
chapter. 

4 Check that "/usr/hp64000/bin" and "." are in your $PATH environment variable. 
(Type "echo $PATH" to see the value of $PATH.) 
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To prepare to run the debugger 



5 If the debugger software is installed on a different kind of computer than the 
computer you are using, edit the "platformScheme" in the Xdefaults.all and 
Xdefaults.emul files. These files are located in 

/usr/hp64000/demo/debug_env/hp<emulator>, where <emulator> is the HP product 
number of the emulator (or other execution engine) you are using. For example, if 
you are sitting at a Sun workstation which is networked to an HP 9000 Series 300 
workstation, change the platformScheme to "SunOS". 
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To start the debugger 



To start the debugger 

1 Change to the debugger demo directory: 

cd / usr/hp64 000/demo/debug_env/ <emulator> 

where <emulator> is the HP product number of the emulator you are using. 

2 Start the debugger by entering: 

Startdebug emul68k 

This will set some environment variables, start the debugger, load a configuration 
file, and load a program for you to look at. 

If the logical name of your emulator is not emul68k, then use the name of your 
emulator instead of emul68k. If you do not know the name of your emulator, see 
"To find the logical name of your emulator" in the "Installation" chapter of this 
manual. 

The Startdebug script will ask you whether it should copy the demo files to another 
directory. If you have a C compiler available, answer "y". (You cannot modify the 
files in /usr/hp64000/demo.) 

Or, if you have installed the emulator/analyzer and Software Performance Analyzer 
interfaces, you can use the following command to start all of the interfaces: 

Startall einul68k 

Note If you were debugging your own program, you would need to enter a command 

like: 

db68k: -e emulGSk -C Config -c mycmd ecs 

This command starts the debugger, which executes the command file mycmd.com 
and loads the absolute file ecs.x. See the "Loading and Executing Programs" 
chapter for more details. 
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To activate display area windows 

Notice there are several windows in the main display area of the debugger. The 
different windows contain different types of information from the debugger. The 
active window has the thicker border. 

1 Use the right mouse button to click on the border of the Monitor window. 

Be sure to chck only once (do not "double-click"). The Monitor window should 
now have a thick border. Now activate the Code window: 

2 Use the right mouse button to click on the border of the Code window. 

If you chck on the border of the active window, it will be expanded. Just chck 
again to show the window in its normal size. 

See the "Debugging Programs" chapter for a Ust of other ways to activate a 
window. 
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To run until mainQ 



1 CUck on the Run til 0 action key. I R""tii() | 

The Code window now shows the main () routine. 

Clicking on the Run til () action key rans the program until the Une indicated by 
the contents of the entry buffer. 

Locate the (): symbol. The area to the right of this symbol is the entry buffer. 
When you started the demonstration program, the debugger loaded the entry buffer 
with the value "main". 



File Display Modify Execution Breakpoints Window 


Settings 




Help 


Action keys: j < Demo > || Disp Src ( ) || DIsp Src PC |f 


Run 


II Run Til 0 1 


Run Xfer | 


|< Your Key >|| Make || CExpr() || Monitor () || 


Step 


II Step Over | 


Step Out 1 


(): 


main 






1 Recall 



-Monitor^ 



1 nuin_checks 8 

2 target_teiiip 9 

3 current_tenip 8 

4 old_data [ee]:teinp 

5 huaici 

6 ave_teap 

7 ave_huiiid 

8 [ei]:teap 



e.eeeeeeE+ee 



Backtrace 

2. B888e436?crte\<unknoi«n> 
1. 88888718 startup\_startup 
8. 8eeeeFCe«aain\nain 



93 extern void do_sort(); 
94 

95 nainO 



/• sets up ascii array and calls combs 




ini t_systein( ) ; 
proc_spec_init( ); 

while (true) 
{ 

update_systeiii( ); 
nuiii_checks++ ; 

interrupt_s imC Snum_checks) ; 
if (graph) 

graph_data(); 
proc_specif icO; 



-Journal- 



-1-1 



> Program Run Until main 

(Temp) Break module main line 96 



STATUS: Command 



68348 MODULE: main 



BREAK •: 1 TRC:Idle 
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To scroll the Code window 



To scroll the Code window 



To see more of the program you can: 

• Use the mouse to operate the vertical scroll bar: 

Chck to go to top of file * 

Chck to go up one hne 
Chck to go up one half page 

Drag shder to move incrementally 



Chck to go down one half page 
Click to go down one line 
Chck to go to end of file ▼ 

• Use the mouse to operate the horizontal scrolling buttons: 



• Use the <Page Up> and <Page Down> keys on your keyboard. 

The scroll bar affects the contents of the active (highlighted) window. 

You might notice that the scroll bar has a "sticky" slider which always returns to 
the center of the scroll bar. This is so that you can always do local navigation even 
in very large programs. Use the Disp Src () action key or the Display^Source () 
puU-down menu item to move larger distances. 
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To display a function 



To display a function 

1 Position the cursor over the call to init_system. 

2 CUck the left mouse button. 

This will place the string "init_system" into the entry buffer. 

3 CUck on the Disp Src () action key. 

4 Scroll up one line to see the "init_system()" line. 

You should now see the source code for the init_system{)m\x]xa& in the Code 
window. 



File Display Modify Execution Breakpoints Window 


Settings 






Help 


Action i<eys: | < Demo > || Disp Src ( ) |{ Disp Src PC || 


Run 


II Run Til 0 1 


Run Xfer 


1 


|< Your Key >|| Make || CExpr() || Monitor () || 


Step 


II Step Over | 


Step Out 


1 


(): 


init_sijsten 








Recall 



num_checl<s 
target_teTnp 
current_temp 
old data 



-Honitoi — 



Ceei itenp 

humid 

ave_temp 
ave_huinid 
[81] itenip 



e.eeeeeeE-fee 



Baclctrace 

2. eeeee43e?crte\<unknoin> 

1. eeeeevia startup\_5tartup 

8. eeeeeFCe«iiain\aain 



31 
32 
33 
34 
35 
36 
37 
38 
39 
48 
41 
42 
43 
44 
45 
46 
47 



/• FUNCTION init_systein() •/ 

/* Initialize the target values for temperature and humidity •/ 

target_teinp = 73; 
target_huinid = 45; 

/• Intialize the variables indicating the current environment «/ 
/• conditions •/ 
current_temp = 68; 

current_huTnid = 41; 

/* Set starting directions for temp and hunid */ 
temp_dir = up; 
humid_dir - up; 

/• Initialize the variables that depict the current status of the */ 
/* computer room and uhat hardware needs to be on or off in the room « 
func_needed = 8; 



-Journal- 



> Program Context Set init_8ystem 

> Program Di8play_Source init_system 



■'1 



t: 1 TRC:Idle I ^ I ^ I 



STATUS: Command 



68348 MODULE: init_systea 



BREAK 
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To run until a line 



To run until a line 

1 Position the cursor over line 34. The hand-shaped cursor means that a pop-up 
menu is available. 

31 { /* FUNCTION init_systein() */ 

32 /* Initialize the target values for temperature and huviditij */ 

33 target_teinp = 73; 

34 target_huaid =45;'^ 

2 Hold down the right mouse button to display the Code window pop-up menu. 
Move the mouse to Run until, then release the button. 



Debugger Display 
Set/Delete Breakpoint 
Edit source 
Attach Macro ... 

Edit Attached Mscro,,, 

Run until ^ 

Trace after 
Trace before 
Trace about 
Trace until 



Line 34 should now be highlighted. Notice that "init_system" now appears in the 
Backtrace window at level 0, which means that the program counter is inside the 
init_system() function. 
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To edit the program 

This step assumes you are using an HP Advanced Cross Language System 
compiler (HP B3640). If you are using another compiler, skip this step. 

Suppose we wanted the initial value of targetjemp to be 74 instead of 73. The 
debugger makes it easy to change the source code: 

1 Place the cursor over the assignment to targetjemp (line 33). 

2 Hold the right mouse button and select Edit Source from the Code window pop-up 
menu. 



Debugger Display 
Set/Delete Breakpoint 
Edit source ^ 
Attach Macro ... 
Edit Attached Macro ,„ 
Run until 
Trace after 
Trace before 
Trace about 
Trace until 



An editor will appear in a new X window. The default text editor is vi. You can 
use a different text editor by editing X resources (described in the "Configuring the 
Debugger" chapter). 

3 Changethe"73"to"74". 

4 Exit the editor. 

5 CUck on the Make action key. 

The program will be re-compiled with the new value and reloaded. 
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To display init_system() again 



To display init_system() again 

• Click on the Disp Src() action key. 

Since "init_system" is still in the entry buffer, the init_system() routine is displayed. 
You have now completed a edit-compUe-load programming cycle. 



To set a brealcpoint 

We want to run until just past the line that we changed. 

1 Position the mouse pointer over line 42. 

2 CUck the right mouse button to set a breakpoint. 

The breakpoint window is displayed, showing the breakpoint has been added. 

An asterisk (*) appears in the first column of the Code window next to the location 
of the breakpoint. Dots apppear in front of any other lines (such as comments) 
associated with the breakpoint. 
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To run until the breakpoint 



• Click on the Run Xfer action key to run the program from its transfer address. 



While the program is executing, the menus and buttons are "grayed out," and an 
"hourglass" mouse pointer is displayed. You cannot enter debugger commands 
while the program is executing. If you need to stop an executing program, type 
<Ctrl>-C with the mouse pointer in the debugger X window. 

After a few moments, Une 42 will be highhghted, showing that program execution 
stopped there. 

The Journal window shows that a break occurred and which breakpoint it was. 



File Display Modify Execution Breakpoints Window 


Settings 






Help 


Action keys: | < Demo > || Disp Src ( ) || C Expr ( ) |f 


Run 


1 RuntilO 1 


Step Over 


1 


|< Your Key >|| Make ||DlspSrcPC|| Monitor () jj 


Step 


1 Run Xfer | 


Step Out 


1 


(): 


init.systen 








Recall 




Monitoi 3- 




— Backtrace- 


4- 





nuTii_checlcs 
target_teinp 
current_teiip 
old_data 



8 

74 
68 

Caeiitenp 

humid 
ave_teiiip 
ave_huinid 
[81]:te>p 



e.eeeeesE+ee 
e.eeeeeeE+ee 



3. 88e8e436?crt0\<unknouin> 
2. 88888718 startup\_startup 
1. eeeeerCA nain\>ain 
e. eeeeiSeC init_si|stea\init_sij 



39 
48 
41 

43 
44 

45 
46 
47 
48 
49 
58 
51 
52 
53 
54 
55 



current_huiiid = 41; 



/» Set starting directions for teap and huaid •/ 



temp dir = u 



liunid_dir = up; 

/• Initialize the variables that depict the current status of the •/ 
/• computer room and ahat hardaare needs to be on or off in the room • 
func_needed = 8; 
hdur_encode = 8; 

/•Initialize the count of calls to update_stBte_of_systea() •/ 
num_checks = 8; 

/» Initialize writing location in old_array •/ 

curr_loc = 0; 



— Journal- 



> Program Run 

Break it 1 on instr nodule init_sijstein line 42 



-1-1 



STATUS: InMon 



68348 MODULE: init.system 



BREAK •: 1 TRC:Idle 
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To patch code using a macro 



1 Position the cursor over line 38. 



2 Select Attach Macro from the Code window pop-up menu. 



39 



current temp 



current_huiiid = 41; 



Debugger Display 



Set/Delete Brealtpoint 
Edit source 



Attach Macro ... 



Edft Attached Macro ... 



Run until 



The Macro Operations dialog box appears. The macro "patch_temp" is already 
selected. Before we attach the macro, let's examine it: 



Debugger/Emulator: Macro Opei atiai 



Defined Macros 



writep(port, size, value) 
write(fildes, buf, nbyte) 

<User-Defined lvlacros> 



graph_on() 
do_forward() 
show_num() 
latcli temi: 



Parameters: 



Selected Macro 



I Recall I 



patch_temp 



3 CUck on the Edit button in the dialog box. 



This macro will set current Jemp to 71 each time the breakpoint is encountered. 
The macro skips over the assignment in the program source code by setting the 
program counter to line 39. The return value of 0 tells the macro to stop program 
execution after the macro. 
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Debugger Macro Add int patch_temp ( ) 

{ 

/* set the current_temp to be 71 degrees instead of what the code says */ 
current_temp - 71; 

/* Restart execution at line # 39 — Skips over the code too!! */ 
$Memory Register @PC = #39$; 

/* Return value indicates continuation logic: l=continue, 0=break */ 
return (0) ; 

} 



4 Exit the editor. 

5 Click on the Attach button in the dialog box. 

The plus sign ("+") in front of line 38 indicates that a macro has been attached to a 
breakpoint at that Une. 

6 Click on the Run Xfer action key to run the program. 

Notice that currentjemp, as shown in the Monitor window, is 71, not 68. CUck 
Disp Src PC to show the source in the code window. 



To delete a single breakpoint 

Once you set a breakpoint, program execution will break each time the breakpoint 
is encountered. If you don't want to break on a certain breakpoint again, you must 
delete the breakpoint. Suppose you want to delete the breakpoint that was 
previously set at Une 42 in init_system. 

1 Position the mouse over line 42. 

2 CUck the right mouse button to delete the breakpoint. 

The breakpoint window shows the breakpoint has been deleted. The asterisk in 
front of Une 42 disappears. 
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To delete all breakpoints 



To delete all breakpoints 

1 Position the mouse pointer in the Breakpoint window. 

2 Hold down the right mouse button to select Delete All Breakpoints from the 
Breakpoint window pop-up menu. 

All breakpoints are deleted. 
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To step through a program 

You can execute one source line (high-level mode) or one instruction 
(assembly-level mode) at a time by stepping through the program. 



• Chck on the Step action key a few times. 



• If you want to try using a pull-down menu, select Execution^Step^from PC a 
few times. 

As the debugger steps through the program, you can see the PC (PC) progress 
through the source code, as shown by the inverse video line in the Code window. 



To run until a stack level 

Now we need to go back to main( ). You can run the program until it enters main( ) 
by running to a stack level. 

1 Position the mouse pointer over the line containing "mainVmain" in the Backtrace 
window. 



2 Select Run UntU Stack Level from the Backtrace pop-up menu. 

The program counter is now back in main( ), on the call to proc_spec_init( ). 



-Backtrace 



ririnnri4-lFi'"rri:ri'. ijrikrinnjn> 



jpi \_.5tartup 



e. eeeeiEsi 



Backtrace Display 



Highllght/Toggle Window 

Remove Window 



Disp Source at Stack Level 
Disp Vars at Stack L^el 



Run Until Stack l.evel 

>r- 
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To step over functions 



To step over functions 

You can either step through functions or step over functions. When you step over a 
function, it is executed as a single program step. 

• Chck on the Step Over action key. 

The next hne in main( ) is highlighted. The routine proc_spec_init( ) was executed 
as a single program step. 



To step out of a function 

1 CUck on the Step action key until the program counter is in update _system{ ). 

2 CUck on the Step Out action key. 

The program will execute until it retums from update_system( ). 



To display the value of a variable 

1 Use the left mouse button to highlight "num_checks" in the Code window. 

2 Chck on the C Expr () action key. 

In the Journal window, the current value of the variable is displayed in its declared 
type (int). Notice that this is the same as the value displayed in the Monitor 
window. 
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To change the value of a variable 



To change the value of a variable 

1 In the entry buffer, add "=10" after "num_checks". 

2 Click on the C Expr () action key. 

The new value is displayed in the Journal window and in the Monitor window. 



File Display Modify Execution Breakpoints Window 


Settings 






Help 


Action keys: | < Demo > || Disp Src ( ) || CE>!pr() || 


Run 


1 RuntilO 1 


Step Over 




|< Your Key >|| Make || Disp Src PC || Monitor () || 


Step 


1 RunXfer | 


Step Out 




(): 


nuin_checks=10 






1 Recall 




Hon i t or 3- 




— Backtrace- 


4^ 





nuin_checks 
target_tenip 
current_teinp 
old_data 



76 
70 

[8e]:tnp 
hunid 

ave_teiiip 
ave_hum i d 
[01] :teiiip 



70 
43 

e.eeeeeeE+ee 
0.eeae9eE+ee 

65 



2. 00000436?crt0\<unknouin> 
1. 00000710 startup\_startup 
0. 00000FD8 mainXiaain 



100 
101 
182 



hile (true) 



update_systeiii( ); 



num checks++; 



interrupt_siiii(4nuin_checks) ; 
if (graph) 

graph_data( ) ; 
proc_specif icO; 



194 
IBS 
196 
107 
108 
199 } 
119 

111 /•*•*•**«*•*•****«••*•*«•*•*•*•••«•«••*•••«*•*•*•«•«**••*««••••••*•«*•««*« 

112 • FUNCTION: interrupt_sill 

113 • FARMS: counter — loop counter passed in fron nain 

114 • DESCRIPTION: 

115 * create a simulation of a (usually) long interrupt service routine tha 



-Journal- 



-1- 



> Expression C_Expression nuin_checks=19 
Result is: 19 9x9A 



STATUS: Coaaand 



68349 MODULE: nain 



BREAK «: 1 TRC:Idle 
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To recall an entry buffer value 



1 Click on the Recall button. 



2 In the Recall dialog box, chck the left mouse button on "num_checks". 



3 In the Recall dialog box, chck the left mouse button on OK. 



The string "num_checks" is now in the entry buffer. 



^ebugger/Emulator^nftj^uff^ 



Previous Entry Buffer Values 



init_system 
graph 

interrupt.sim 
nit_val_BiT 
read_conditjons 
main 

update system 



num checks 



num checks=10 



(): 



nunchecks. 



OK 



Apply 



Cancel 
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To display the address of a variable 

You can use the C address operator (&) to display the address of a program 
variable. 

1 Position the mouse pointer in the entry buffer. 

2 Type "&" in the entry buffer so that it contains "&num_checks". 

(): gnuM_checks | Recall | 

3 CUck on the C Expr () action key. 

The result is the address of the variable num_checks. The address is displayed in 
hexadecimal format. 

I Journa 1 1— 

> Expression C_Expression SnuB_checks 

Result is: data address eeee76F2 {nun.checks} 
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To break on an access to a variable 

If you started the debugger using the Startall script, skip this section. Access 
breakpoints are disabled because the analyzer has been configured to use the Trig2 
trigger for other purposes. 

If you are using an HP Software Probe, skip this section. Access breakpoints 
require the use of an analyzer. 

You can also set breakpoints on a read, a write, or any access of a variable. This 
helps to locate defects due to multiple functions accessing the same variable. 
Suppose you want to break on the access of the variable num_checks. 
("&num_checks" should still be in the entry buffer.) 

1 Set the breakpoint by selecting Breakpoints^Set^Read/W rite (). 

2 Run the program by chcking on the Run action key. 

When the program stops, the code window shows that the program stopped at the 
next reference to the variable num_checks. Due to the latency of the emulation 
analyzer, the processor may halt several cycles after the breakpoint has been 
detected. 

Try running the program a few more times to see where it stops. (Notice that 

num_checks is passed by reference to interrupt_sim. Since counter points to the 
same address as num_checks, the debugger stops at references to counter.) 

3 Delete the access breakpoint. Select Window^Breakpoints, place the mouse in 
the Breakpoint window, press and hold the right mouse button, and choose Delete 
All Breakpoints. 
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To use the command line 

1 Select Settings^Command Line from the menu bar. 

The command hne area which appears at the bottom of the debugger window can 
be used to enter complex commands using either the mouse or the keyboard. 

2 Build a coinmand out of the command tokens which appear beneath the command 
line entry area. 

To use the command Une with the mouse, cUck on the button for each command 
token. 

3 When the command has been built, type or select <Retum>. 



To use a C printf command 

The command line' s Expression Printf command prints the formatted output of the 
command to the Journal window using C format parameters. This command 
permits type conversions, scaling, and positioning of output within the Joumal 
window. 

1 Place the string "num_checks=10" in the entry buffer by using the Recall button. 

2 Chck the C Expr () action key to assign 10 to num_checks. 

3 Using the command line, enter: 

Expression Printf "%010d" , num_checks 

Journa 1 1— 

> Expression Printf *ill819d",nm checks 

eeeeeeeeii 

In this example, the value of num_checks is printed as a decimal integer with a 
field width of 10, padded with zeros. 
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To turn the command line off 

1 Move the mouse pointer to the Status line. 

2 Hold down the shift key and cUck the right mouse button. 

The shift-click operation selects the second item from a pop-up menu, which in this 
case is Command Line On/Off. 

You can turn the command Une on and off from the Settings pull-down menu, the 
Status pop-up menu, and the command line pop-up menu. 



To trace events following a procedure call 



1 Position the mouse pointer over the call to update_system( ) on Une 102. 



2 Select Trace after from the Code window pop-up menu. 



183 

185 
186 
187 
188 
189 



update SMstemC ) ; 



nuTD checks++; 



if (graph) 

graph_data(); 
proc_spec i f i c( ) ; 



Debugger Display 



Set/Delete Breakpoint 
Edit source 



Attacli Macro ... 

Edit Attaclied Macro , 



Run until 



Trace after 



Trace before 
Trace about 
Trace until 



3 Run the program by cUcking on the Run action key. 



Notice that the debugger interface is "grayed out" and that the mouse pointer is an 
hourglass when the mouse is in the debugger X window. This means that the 
program is executing. 
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4 Wait for the status line to show TRC : Cmplt, then press <Ctrl>-C in the debugger 
window. 

5 Select Window^Trace to see the bus states which occurred after the call to 
update_system( ). 

The trace listing will be displayed in the Trace Mode debugger window. If an 
emulator/analyzer X window is active, it will display the trace Usting. You can 
scroll through the trace to see more bus states. 



Trace Mode 24 



In update_sijs\update_sijstein. Line 48.. 53 

Lines 48.. 53 get_targets(8target_tenp, 8target_hiinid); 

73. Lines 78.. 94 { 
589. Line 95 HAKEBAR(ARG3); 

510. Reenter updatesysNgettargets 

Line 9S HflKEBfiR( flRG3 ) ; 



ESC-ESC=Quit mode F2=Neui Top Line F6=Track Direction^) F7=Track 



6 Press the <ESC> key to exit the trace display. 
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To see on-line help 

1 Select Help^General Topic ... 

2 Select To Use Help, then click on the OK button. 

Spend a few minutes exploring the help topics, so that you can find them when you 
need them. 
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To end the debugging session 

• Use the command select mouse button to choose File^Exit^Released (all 
windows, release emulator). 



File 






Context > 
Load > 
Store > 
Copy Window > 

Log > 




Emul700 > 
Edit > 

Term ... 


Exit > 


Window (save session) <Ctrl>X 
Locked (all windows, save session) 




Released (all windows, release emulator) ^ 



The debug session is ended and your system prompt is displayed. The Released 
option unlocks the emulator so that other users on your system can use it. 



This completes your introduction to the 6833x7340/360 Debugger/Emulator. You 
have used many features of the debugger. For additional information on 
performing tasks with the debugger, refer to the "User's Guide" part of this manual. 
For more detailed information on debugger commands, error messages, etc., refer 
to the "Reference" part of this manual. 
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Part 2 
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Entering Debugger Commands 

How to enter debugger commands using the mouse or the keyboard. 
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This chapter shows you how to enter debugger commands using the graphical 
interface or the standard interface. The tasks are grouped into the following 
sections: 

• Starting the debugger. 

• Using menus, the entry buffer, and action keys. 

• Using the command line with the mouse. 

• Using the command line with the keyboard. 

• Viewing debugger status. 

The graphical interface provides an easy way to enter commands using a mouse. It 
lets you use pull-down and pop-up menus, point and click setting of breakpoints, 
cut and paste, on-line help, customizable action keys and pop-up recall buffers, and 
other advanced features. To use the graphical interface, your computer must be 
running an X Window System that supports OSF/Motif interfaces. 

The debugger also has a standard interface for several types of terminals, terminal 
emulators, and bitmapped displays. When using the standard interface, commands 
are entered from the keyboard. 

When using the graphical interface, the command line portion of the interface gives 
you the option of entering commands in the same manner as they are entered in the 
standard interface. If you are using the standard interface, you can only enter 
commands from the keyboard using the command Une. 



Chapter 2: Entering Debugger Commands 



Function Key Commands 

You can enter commonly used commands quickly and easily by pressing the 
function keys Fl through F8 on your keyboard. Function keys can be used in the 
graphical interface as well as the standard interface. The following table and figure 
describe the commands associated with the function keys. 



If you are using the debugger on a Sun SPARCsystem, refer to the "Installation" 
chapter for information on mapping function keys. 



Function Key Commands 


Function 
Key 


Grapiiical Equivalent, 
Command Line Equivalent 


Description 


Fl 


Display^Next Window, 

Window Active Next 


Activate the next higher numbered window. 


F2 


Display^Previous Window, 

window Active Previous 


Activate the next lower numbered window. 


F3 


Settings^High Level Debug or 
Settings^Assembly Level Debug, 

Debugger Level 


Switch between assembly- level and high-level 
mode. 


F4 


Right click on active window border. 

Window Toggle_View 


Select the altemate display of the active 
window. 


F5 


Help^Command Line..., 

Debugger ? (Help) 


Access on-hne help. 


F6 


Display^Simulated I/O, 

Window Screen_On Next 


Access the standard I/O screen. Also access 
any existing user-defined screens. 


F7 


Execution^Step Instruction^from PC, 

Program Step 


Execute one C source Une (high-level mode), 
or execute one microprocessor instruction 
(assembly-level mode). 


F8 


Execution^Step Source^from PC, 

Program Step Over 


Execute one C source hne, but treat whole 
functions as a single line (high-level mode); 
execute one microprocessor instruction, but 
treat whole subroutines as a single instruction. 



41 



Chapter 2: Entering Debugger Commands 



Command Line Control Character Functions 

Press the control key <Ctrl> simultaneously with the B, C, E, F, G, L, Q, R, S, U, 

or \ keys to execute the operations listed in the following table. (The letter keys 
may be upper- or lower-case.) 



Command Line Control Character Functions 



Control 




Function 


<Ctrl> 


B 


Recall command reverse. 


<Ctrl> 


C 


Abort the current command and return to debugger command mode. 


<Ctrl> 


E 


Clear to end of command Une. 


<Ctrl> 


F 


Shift contents of active window to right. 


<Ctrl> 


G 


Shift contents of active window to left. 


<Ctrl> 


L 


Redraw screen. 


<Ctrl> 


Q 


Resume output to screen (standard interface only). 


<Ctrl> 


R 


Recall previous command. 


<Ctrl> 


S 


Suspend output to screen (standard interface only). 


<Ctrl> 


U 


Clear command line 


<Ctrl> 


\ 


End the debug session (same as Debugger Quit Yes command) 



The Journal Window 

The debugger displays debugger commands entered from the keyboard in the 
Joumal window. The Journal window also displays warning and informational 
messages from the debugger and output generated by commands. This window is 
available in both the high-level and assembly-level screens. 



42 



Chapter 2: Entering Debugger Commands 
Starting the Debugger 



Starting the Debugger 

Use the db68k command to start the debugger. 

See Also The "Getting Started with the Graphical Interface" chapter for information about 

starting the graphical interface. 

The "Getting Started with the Standard Interface" chapter for information about 
starting the standard interface. 

The "Loading and Executing Programs" chapter for information about loading 
programs as you start the debugger. 

The "Using Macros and Command FUes" chapter for information about loading 
command files as you start the debugger. 

The "Configuring the Debugger" chapter for information about using debugger 
startup files. 

The on-line "manual page" for information about the db68k command and its 
command-Une options. To see this information, type the following operating 
system command: 

man db58k 
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Using Menus, the Entry Buffer, and Action Keys 

This section describes the tasks you perform when using the debugger's graphical 
interface to enter commands. This section describes how to: 

• Choose a pull-down menu item using the mouse. 

• Choose a pull-down menu item using the keyboard. 

• Use the pop-up menus. 

• Use action keys. 

• Use the entry buffer. 

• Copy and paste to the entry buffer. 

• Use dialog boxes. 

• Access help information. 



To choose a pull-down menu item using the 
mouse (method 1) 

1 Position the mouse pointer over the name of the menu on the menu bar. 

2 Press and hold the command select mouse button to display the menu. 

3 While continuing to hold down the mouse button, move the mouse pointer to the 
desired menu item. If the menu item has a cascade menu (identified by an arrow 
on the right edge of the menu button), then continue to hold the mouse button down 
and move the mouse pointer toward the arrow on the right edge of the menu. The 
cascade menu will display. Repeat this step for the cascade menu until you find the 
desired menu item. 

4 Release the mouse button to select the menu choice. 
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If you decide not to select a menu item, simply continue to hold the mouse button 
down, move the mouse pointer off of the menu, and release the mouse button. 

Some menu items have an ellipsis ("...") as part of the menu label. An ellipsis 
indicates that the menu item will display a dialog or message box when the menu 
item is chosen. 



Note The command select button can be either the left or right button, depending on the 

computer you are using. The "Getting Started with the Graphical Interface" chapter 
has a table which explains which button to use. 



To choose a pull-down menu item using the 
mouse (method 2) 

1 Position the mouse pointer over the menu name on the menu bar. 

2 CUck the command select mouse button to display the menu. 

3 Move the mouse pointer to the desired menu item. If the menu item has a cascade 
menu (identified by an arrow on the right edge of the menu button), then repeat the 
previous step and then this step until you find the desired item. 

4 Click the mouse button to select the item. 

If you decide not to select a menu item, simply move the mouse pointer off of the 
menu and click the mouse button. 

Some menu items have an elhpsis ("...") as part of the menu label. An ellipsis 
indicates that the menu item will display a dialog or other box when the menu item 
is chosen. 
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To choose a pull-down menu Item using the 
keyboard 

• To initially display a pull-down menu, press and hold the menu select key (for 
example, the "Extend char" key on a HP 9000 keyboard) and then type the 
underlined character in the menu label on the menu bar. (For example, 'T' for 
"File". Type the character in lower case.) 

• To move right to another pull-down menu after having initially displayed a menu, 
press the right-arrow key. 

• To move left to another pull-down menu after having initially displayed a menu, 
press the left-arrow key. 

• To move down one menu item within a menu, press the down-arrow key. 

• To move up one menu item within a menu, press the up-arrow key. 

• To choose a menu item, type the character in the menu item label that is 
underlined. Or, move to the menu item using the arrow keys and then press the 
<RETURN> key on the keyboard. 

• To cancel a displayed menu, press the Escape key. 

The interface supports keyboard mnemonics and the use of the arrow keys to move 
within or between menus. For each menu or menu item, the underhned character 
in the menu or menu item label is the keyboard mnemonic character. Notice the 
keyboard mnemonic is not always the first character of the label. If a menu item 
has a cascade menu attached to it, then typing the keyboard mnemonic displays the 
cascade menu. 

Some menu items have an elHpsis ("...") as part of the menu label. An ellipsis 
indicates that the menu item will display a dialog or other box when the menu item 

is chosen. 

Dialog boxes support the use of the keyboard as well. To direct keyboard input to 
a dialog box, you must position the mouse pointer somewhere inside the 
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boundaries of the dialog box. That is because the interface keyboard focus policy is 
set to pointer. That just means that the window containing the mouse pointer 

receives the keyboard input. 

In addition to keyboard mnemonics, you can also specify keyboard accelerators 
which are keyboard shortcuts for selected menu items. Refer to the "Setting X 
Resources" chapter and the "Debug.lnput" scheme file for more information about 
setting the X resources that control defining keyboard accelerators. 



To choose pop-up menu items 

1 Move the mouse pointer to the area whose pop-up menu you wish to access. (If a 
pop-up menu is available, the mouse pointer changes from an arrow to a hand.) 

2 Press and hold the right mouse button. 

3 After the pop-up menu appears (whUe continuing to hold down the mouse button), 
move the mouse pointer to the desired menu item. 

4 Release the mouse button to select the menu choice. 

If you decide not to select a menu item, simply continue to hold the mouse button 
dovm, move the mouse pointer off of the menu, and release the mouse button. 

Some pop-up menus which are available include: 

• Display-area Windows. 

• Status Line. 

• Command Line. 
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To use pop-up menu shortcuts 

• To choose the first item in a pop-up menu, chck the right mouse button. 

• To choose the second item in a pop-up menu, hold down the <Shift> key and click 
the right mouse button. 



To place values into the entry buffer using the 
keyboard 

1 Position the mouse pointer within the text entry area. (An "I-beam" cursor will 
appear.) 

2 Enter the text using the keyboard. 

To clear the entry buffer text area from beginning until end, press the <Ctrl>U key 
combination. 



To copy-and-paste to the entry buffer 

• To copy and paste a "word" of text, position the mouse pointer over the word and 
click the left mouse button. 

• To specify the exact text to copy to the entry buffer, position the mouse pointer 
over the first character to copy, then hold the left mouse button while dragging the 
mouse pointer over the text. When you release the mouse button, the highlighted 
text will appear in the entry buffer. 

You can copy-and-paste from the display area, the status hne, and from the 
command line entry area. 
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Note If you have several graphical interface windows connected to the emulator, then a 

copy-and-paste action in any window causes the text to appear in all entry buffers 
in all windows. That is because although there are several entry buffers being 
displayed, there is actually only one entry buffer, which is shared by all windows. 
You can use this to copy a symbol or an address from one window to another 
window. 

On a memory or trace display, you may need to scroll the display to show more 
characters of a symbol. 

The interface displays absolute addresses as hex values. If you copy and paste an 
address from the display to the entry buffer, you must add a trailing "h" to make 
the interface interpret it as a hex value when you use the entry buffer contents with 
a command. 

Text pasted into the entry buffer replaces that which is currently there. You cannot 
use paste to append text to text already in the entry buffer. You can retrieve 
previous entry buffer values by using the Recall button. 

See "To copy-and-paste from the entry buffer to the command line entry area" for 
information about pasting the contents of the entry buffer into the command hue 
entry area. 



Example To paste the symbol "init_system" into the entry buffer from the interface display 

area, position the mouse pointer over the symbol and then cUck the left mouse 
button. 



( ): init_sa5teTii [Recall 

96 { 

97 HSKMSHISH f > ; 

98 proc_spe$init(); 
99 
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To recall entry buffer values 

1 Position the mouse pointer over the Recall button just to the right of the entry 
buffer text area, and cUck the mouse button to bring up the Entry Buffer Value 
Selection dialog box. 

2 In the dialog box, click on the string you want. 

3 In the dialog box, click on the "OK" button. 

The Entry Buffer Value Selection dialog box contains a list of previous values from 
the entry buffer. You can also predefine entries for the Entry Buffer Value 
Selection dialog box and define the maximum number of entries by setting X 
resources (refer to the "Setting X Resources" chapter). 

If you decide not to change the contents of the entry buffer, click on the "Cancel" 
button in the dialog box. 

If you want the Entry Buffer Value Selection dialog box to remain visible after you 
make a selection, press "Apply" instead of "OK". You may drag the dialog box to 
another location on your display so that it does not cover the debugger window. 

See the following "To use dialog boxes" section for information about using dialog 
boxes. 
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To edit the entry buffer 

• To position the keyboard cursor, click ttie left mouse button or use the arrow keys. 

• To clear the entry buffer, type <Ctrl>-U. 

• To delete characters, press the <Backspace> or <Delete char> keys. 

• To delete several characters, highlight the characters to be deleted using the left 
mouse button, then press the <Backspace> or <Delete char> keys. 



To use the entry buffer 

1 Place information into the entry buffer (see the previous "To place values into the 
entry buffer using the keyboard", 'To copy-and-paste to the entry buffer", or "To 
recall entry buffer values" task descriptions). 

2 Choose the menu item, or cUck the action key, that uses the contents of the entry 
buffer. 

The contents of the entry buffer will be used wherever the "()" symbol appears in a 
menu item or action key. 



To copy-and-paste from the entry buffer to the 
command line entry area 

1 Position the mouse pointer within the command Une text entry area. 
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2 If necessary, reposition the keyboard cursor to the location where you want to paste 
the text. 

3 If necessary, choose the insert or replace mode for the command entry area. 

4 Click the middle mouse button to paste the text into the command Une entry area at 
the current cursor position. 



Note You should paste to the command Une only when the command line is expecting an 

address or a string. The characters from the entry buffer will be treated as if they 
were typed from the keyboard. If the command line is expecting keyword tokens, 
pasting can have unexpected results. For example, pasting "delta" into an empty 

command line will generate a "Debugger Execution Load_State ta" command! 



Although a paste from the display area to the entry buffer affects all displayed 
entry buffers in all open windows, a paste from the entry buffer to the command 
line only affects the command line of the window in which you are currently 
working. 

See "To copy-and-paste to the entry buffer" for information about pasting 
information from the display into the entry buffer. 



To use the action keys 

1 If the action key uses the contents of the entry buffer, place the desired information 
in the entry buffer. 

2 Position the mouse pointer over the action key and click the action key. 

Action keys are user-definable pushbuttons that perform interface or system 
functions. Action keys can use information from the entry buffer — this makes it 
possible to create action keys that are more general and flexible. 

Several action keys are predefined when you first start the debugger's graphical 
interface. You can use the predefined action keys to make, load, run, and step 
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through the demo program. You'll really appreciate action keys when you define 
and use your own. 

Action keys are defined by setting an X resource. Refer to the chapter "Setting X 
Resources" for more information about creating action keys. 



To use dialog boxes 

1 Click on an item in the dialog box list to copy the item to the text entry area. 

2 Edit the item in the text entry area (if desired). 

3 Click on the "OK" pushbutton to make the selection and close the dialog box, click 
on the "Apply" pushbutton to make the selection and leave the dialog box open, or 
cUck on the "Cancel" pushbutton to cancel the selection and close the dialog box. 

The graphical interface uses a number of dialog boxes for selection and recall: 

Directory Selection Selects the working directory. You can change to a 

previously accessed directory, a predefined directory, or 
specify a new directory. 

File Selection From the working directory, you can select an existing file 

name or specify a new file name. 

Entry Buffer Recall You can recall a previously used entry buffer text string, a 
predefined entry buffer text string, or a newly entered entry 
buffer string, to the entry buffer text area. 

Command Recall You can recall a previously executed command, a 

predefined command, or a newly entered command, to the 
command line. 

The dialog boxes share some common properties: 

• Most dialog boxes can be left on the screen between uses. 

• Dialog boxes can be moved around the screen and do not have to be positioned 
over the graphical interface window. 
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• If you iconify the interface window, all dialog boxes are iconified along with 
the main window. 

Except for the File Selection dialog box, predefined entries for each dialog box 
(and the maximum number of entries) are set via X resources (refer to the "Setting 
X Resources" chapter). 

In file names, you may use a tUde as shorthand for your home directory. 
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Examples 



To use the File Selection dialog box: 



The file filter selects 
specific files. 



A list of 

filter-matching files. 



A list of files 
previously accessed 
during the debugger 
session. ~ 

A single click on a 
file name from either 
Ust highlights the file 
name and copies it to 
the text area. A 
double click chooses 
the file and closes the 
dialog box. 

Label informs you 
what kind of file 
selection you are 
performing. 



/ 



Text entry area. Text is 
either copied here from 
the recall list, or entered 
directly. 



Debugger/Emulator: File Selection 



File Filter 



/usr/hp64999/demo/debug_env/hp64747/* . EA 



Files 



/usr/hp64000/demo/debug_env/[ip64747/Config.EA 

/usr/hp64000/demo/debug_env/hp64747/Configall.EA 

/usr/hp64000/denio/debug_env/hp64747/myMMUon.EA 

<PrevioLis Files> 



/usr/hp64000/inst/emul/mntime/0F061926.lan/default.EA 
/usr/hp64000/demo/debug_env/hp64747/Conflg.EA 



Load Configuration 



/usr/hp640e8/deTno/debug_env/hp64747/ 




ckLe 



Clicking this button 
chooses the file name 
displayed in the text 
entry area and closes the 
dialog box. 



I 

Entering a new file filter 
and cUcking this button 
causes a list of files 
matching the new filter 
to be read from the 
directory. 



I 

Clicking this button 
cancels the file selection 
operation and closes the 
dialog box. 
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To use the Directory Selection dialog box: 



Label informs you of 
the type of list 
displayed. 

A single click on a 
directory name from 
the Ust highlights the 
name and copies it 
to the text area. A 
double click chooses 
the directory and 
closes the dialog box. 

A list of predefined 
or previously 
accessed directories. 



Text entry area. 
Directory name is either 
copied here from the 
recall list, or entered 
directly. 



Debugger/Emulator: Directory Selection 



Previous Working Directories 



# To customize the initial list of entries loolt for "dirSelectSub" 

# in the file $HP64000/lib/X11/app-defaults/HP64_Debug 

# and add your own definition to your .Xdefaults file. 

It Use the File->Edit->File pulldown to edit these files. 
# 

$HOME 

$HP64000/monitor 

$HP64000Jdcmo/dcbug_cnv;'hp64747 



/usr/hp64000/demo/debug env/hp64747 



Selection 



/U8r/hp648e0/deiio/debug_env/hp64747 



OK 



Apply 



Cancel 



Clicking this button 
chooses the directory 
displayed in the text 
entry area and closes the 
dialog box. 



Clicking tliis button 
chooses the directory 
displayed in the text 
entry area, but keeps the 
dialog box on the screen 
instead of closing it. 



Clicking this button 
cancels the directory 
selection operation and 
closes the dialog box. 
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To access help information 

1 Display the Help Index by choosing Help^General Topic ... or 
Help^Command Line .... 

2 Choose a topic of interest from the Help hidex. 

The Help Index hsts topics covering operation of the interface as well other 
information about the interface. When you choose a topic from the Help Index, the 
interface displays a window containing the help information. You may leave the 
window on the screen while you continue using the interface. 



Examples 



To see more information on how to use the on-line help, click on Help, then click 
on General Topics then click on "To Use Help", then click on the "OK" button. 



General Topic... 



Command Line... 
Version ... 



X Resource Names , 



Debugger/Emulator; Help Topics Index 



Topics 



-General Information — 

The Interface ... At a Glance 
Common Questions & Answers 
'Vction Keys 

Command Line Operation 
I ): Entry Buffer 
dialog Boxes 
^op-up Menus 
"or More Information 
Glossary 

To Set or Clear Breakpoints 
To Set a Variable 
—Menu Bar- 
pulldown Menus Quick Reference 



To Use Help^ 



Help: Topics 



To Use Help 



Use the [gHB menu to see inforiration about the debugger's graphical 
user interface. 

To see more text, move the mouse to the srrnl lhar on the right side 

of the luindoiiu. Hold the right mouse button mhile you move the mouse up 

and doiun. 



To move the help 
Hold the right m.-i 



To get help on an other 
fflS button in tl 



the mouse to the . 



you drag the nindoiu 



ick on that topic then click on the 
^ \ 111 i ndoiu . 



To save a help top i c in a file Luh i ch you can print or vieui at later 
time, click on the ^^^^^^^^Q button. A file selection dialog box 
ujill ask you to name the file in mhich to save the information. 



|Done||Save to File| 
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Using the Command Line witli tlie Mouse 

When using the graphical interface, the command line portion of the interface gives 
you the option of entering commands in the same maimer as they are entered in the 
standard interface. Additionally, the graphical interface makes the command 
tokens pushbuttons so commands may be entered using the mouse. 

If you are using the standard interface, the command hne is the only way to enter 
commands. 

This section describes how to: 



• Turn the command line off/on. 



• Enter commands. 

• Edit commands. 

• Recall commands. 



• Display the help window. 
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To turn the command line on or off 

• To turn the command line on or off using the pull-down menu, choose 
Settings^Command Line. 

• To tum the command line on or off using the status line pop-up menu: position the 
mouse pointer within the status hne area, press and hold the right mouse button, 
and choose Command Line On/Off from the menu. 

• To tum the command line on or off with a single mouse cUck, hold the <Shift> key 
and chck on the status line. 

• To tum the command line off using the command line entry area pop-up menu: 
position the mouse pointer within the entry area, press and hold the right mouse 
button, and choose Command Line On/Off from the menu. 

• To tum the command line on with the keyboard: place the mouse pointer in the 
display area and press any alphanumeric key. 

"On" means that the command hne is displayed and you can use the command 
token pushbuttons, the command return and recall pushbuttons, and the cursor 
pushbuttons for command line editing. "Off" means the command Hne is not 
displayed and you can use only the pull-down and pop-up menus and the action 
keys to control the interface. 

The command Une area begins just below the status Une and continues to the 
bottom of the debugger window. The status line is not part of the command line 
and continues to be displayed whether the command line is on or off. 

Choosing certain pull-down menu items while the command line is off causes the 
command line to be turned on. That is because the menu item chosen requires 
some input at the command Une that cannot be supplied another way. 
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To enter a command 

1 Build a command using the command token pushbuttons by successively 
positioning the mouse pointer on a pushbutton and clicking the left mouse button 
until a complete command is formed. 

2 Execute the completed command by clicking the Return pushbutton (found near 
the bottom of the command Une in the "Command" group). 

Or: 

Execute the completed command using the Command Line entry area pop-up 
menu: Position the mouse pointer in the command line entry area; press and hold 
the right mouse button until the Command Line pop-up menu appears; then, choose 
the Execute Command menu item. 

You may need to combine pushbutton and keyboard entry to form a complete 
command. 

A complete command is a string of partial commands or command tokens. You 
know a command is complete when "<return>" appears on one of the command 
token pushbuttons. The interface does not check or act on a command, however, 
until the command is executed. (In contrast, commands resulting from menu 
choices and action keys are supplied with the needed carriage return as part of the 
command.) 
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To edit the command line using the command 
line pushbuttons 

• To clear the command line, click the Clear pushbutton. 

• To clear the command line from the cursor position to the end of the Une, click the 
Clear to end pushbutton. 

• To move to the right one command word or token, chck the Forward pushbutton. 

• To move to the left one command word or token, cUck the Backup pushbutton. 

• To insert characters at the cursor position, press the Insert char key to change to 
insertion mode, and then type the characters to be inserted. 

• To delete characters to the left of the cursor position, press the <Backspace> key. 

When the cursor arrives at the beginning of a command word or token, the softkey 
labels change to display the possible choices at that level of the command. 

When moving by words left or right, the Backup pushbutton is grayed out and 
unresponsive when the cursor reaches the beginning of the command string. 

See "To edit the command line using the mouse and the command Une pop-up 
menu" and "To edit the command line using the keyboard" for information about 
additional editing operations you can perform. 
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To edit the command line using the command 
line pop-up menu 

• To clear the command line: position the mouse pointer within the Command Line 
entry area; press and hold the right mouse button until the Command Line pop-up 
menu appears; choose Clear Entire Line from the menu. 

• To clear the command line from the cursor position to the end of the hne: position 
the mouse pointer at the place where you want the clear-to-end to start; press and 
hold the right mouse button until the Command Line pop-up menu appears; choose 
Clear to End of Line from the menu. 

• To position the cursor at the next token or the previous token: press and hold the 
right mouse button until the Command Line pop-up menu appears; choose 
Forward Tab or Backward Tab from the menu. 

When the cursor arrives at the beginning of a command word or token, the softkey 
labels change to display the possible choices at that level of the command. 

See "To edit the command line using the mouse and the command line 
pushbuttons" and "To edit the command line using the keyboard" for information 
about additional editing operations you can perform. 



To recall commands 

1 Chck the pushbutton labeled Recall in the Command Line to display the dialog box. 

2 Choose a command from the buffer hst. (You can also enter a command directly 
into the text entry area of the dialog box.) 

Because all command entry methods in the interface — menus, action keys, and 
command line entries — are echoed to the command line entry area, the contents of 
the Command Recall dialog box is not restricted to commands entered directly into 
the command line entry area. 
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The Command Recall dialog box contains a list of interface commands executed 
during the debugger session as well as any predefined commands present at 
interface startup. 

You can predefine entries for the Command Recall dialog box and define the 
maximum number of entries by setting X resources (refer to the "Setting X 
Resources" chapter). 

See "To use dialog boxes" for iirformation about using dialog boxes. 



To get help about the command line 

• To display the help topic explaining the operation of the command Une, select 
Help^General Topic ...^Command Line Operation. 

• To display the command line help menu, select Help^Command Line .... 



To find commands which duplicate a menu 
selection 

To see how a menu item maps to command Une commands: 

1 Select Windows Journal Browser-^Start to open a journal browser window. 

2 Select the menu item. 

Most menu selections generate one or more commands. If you know which 
commands are generated, you can include them in action keys or command files. 
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Using the Command Line witli tlie Keyboard 

Commands are entered on the command line at the debugger prompt (>) and 
executed by pressing the <Return> key. Command tokens are entered by typing a 
single letter, typically the first uppercase letter of the token. 

The third and fourth lines of the status window display command tokens. The third 
line shows the tokens that you can enter at the current location in the command 
line. The fourth line shows tokens that are available if you select the highlighted 
command token on the third line. The command token lines provide you with a 
look ahead feature, showing you the debugger commands available to you at any 
time. 

This section describes how to: 

• Enter commands. 

• Edit commands. 

• Recall commands. 

• Access on-line help information. 



To enter debugger commands from the keyboard 

1 Build a command using direct keyboard entry by successively typing letters 
corresponding to command tokens until a complete command is formed. 

2 Execute a completed command using the keyboard, press the <Return> key on the 
keyboard. 

You can enter commands any time the cursor is displayed on the command hne. 
You can enter only one debugger command at a time. 

Debugger commands have the following syntax: 
command [qualifier. . . ] [parameter . . . ] 
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To enter a command keyword, type the first letter of the keyword. For example, to 
enter the command Debugger Level Assembly, type the letters D, L, and A. The 
following command will appear on the command line: 

Debugger Level Assembly 

Press <Retum> to enter (execute) the command. 

In command examples, the letter you must type is highlighted in bold type. 



Note In cases where you can select from more than one keyword beginning with the 
same letter, type the first uppercase letter of the desired keyword. For example, 
type O to select On and F to select oFF. 



Enter qualifier keywords in the same way as command keywords. Quahfiers 
provide the debugger with information on how to execute the command. Quahfiers 
are normally single words that immediately follow the command name. For 
example, in the command: 

Program Find_Source Next Backward 

the qualifier Backward causes the debugger to search the file from the current 
position in the file towards the beginning of the file for a specified string. 

Type parameters in their entirety from the keyboard. Parameters must be separated 
from the command or quaUfier keyword by at least one space. Parameters describe 
the object of the command and are typically C expressions that represent values or 
addresses used by the command. For example, in the command: 

Expression Display_Value &system_is_running 

the parameter &system_is_running specifies the address of the variable 
system_is_running. 
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To edit the command line 

• To clear the command line, press <Ctrl>U. 

• To clear the command line from the cursor position to the end of the Une, press 
<Ctrl>E. 

• To move to the right one command word, press <Tab>. 

• To move left or right character-by-character, press the <— and —> keys. 

• To delete characters to the left of the cursor position, press the <BACKSPACE> 
key. 

When the cursor arrives at the beginning of a command word or token, the softkey 
labels change to display the possible choices at that level of the command. 



To recall commands using the command line 
recall feature 

• To recall commands from the command line, press the <Ctrl>R key combination. 
Continue to press <Ctrl>R to move from the most recently executed commands 
backward to earUer commands. 

• To move forward in the recall list, press <Ctrl>B. 

The command hne recall feature is available to you, but it is not as easy to use or as 
flexible as the Command Recall dialog box in the graphical interface. You must 
search through commands in a linear fashion instead of going directly to the 
command you want in the dialog box. The depth of the recall hst is predefined and 
carmot be controlled by you. The recall list may contain duplicate entries that you 
must scroll past and that take up room in the recall hst. Finally, you cannot 
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predefine entries for the recall list — the list only contains the most recent 
commands executed during the debugger session. 



To display the help window 

• Press the function key F5. 
Or: 

• Enter the command 
Debugger ? 

This command displays a menu of debugger commands, command parameters, 
function keys, and other debugger features. Descriptions for each topic may be 
obtained by positioning the cursor on the first letter of any topic in the help menu 
and pressing the <Retum> key. 



The debugger' s help window is context sensitive. When you display the help 
window, the cursor is located on the last command you entered before displaying 
the help window. The debugger assumes you need help with this command. Press 
<Retum> to display information about the command. 

Pressing <Return> or <Down> displays information on the next item in the help 
menu. Pressing <Up> displays information about the previous item in the help 
menu. 

You can move the cursor to the first command of a command type (Breakpt, 
Debugger, etc.) by entering the first letter of the command type. For example, to 
move the cursor to the entry for the first window command, enter: 

w 

The cursor will be positioned at the Window Active command entry. Then you can 
use the cursor keys to select the window command you need help with and press 
<Return> to display information on that command. 
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Press the F5 function key one time or press the escape (<Esc>) key twice to exit 
the help window. (Note that you cannot exit the graphical interface help window 
this way.) 
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Viewing Debugger Status 



The status line shows you what the debugger is doing. The status line: 

• Contains information about the operation being performed by the debugger. 

• Contains indicators to warn you about special conditions. 

• Shows the microprocessor being emulated. 

• Shows the program module associated with the current program counter. 

• Shows the number of the last breakpoint that occurred. 

• Shows the trace measurement status. 

The status line is always present in both the graphical interface and the standard 
interface. 

The debugger displays the status line in the following format: 



Debugger Status 

The Status field on the status hne shows the current state of the debugger. The 
possible values for this field are: 



STATUS :<Status> [J] [L] [W] CPU 
[R] 



MODtJLE : <module> 



BREAK #: <#> 



TRC : <Trc_status> 



Command 



The debugger is ready to accept a command or a macro 
definition. 



Execute 



The debugger is executing target environment instructions. The 
debugger displays Execute on the status hne when you enter the 
Program Run command or the Program Step command. 



Compile 



The debugger is reading commands from a command file. 



Macro 



The debugger is executing a macro. 



Paused 



The debugger is in the paused state after execution of the 
Debugger Pause command. 
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Reading The debugger is reading an executable tile or a C source file 

into the debugger's memory. 

Working The debugger is executing internal debugger operations. 

The status field may also display emulator status. See the emulator manual for 
detailed descriptions of the following states: 

InMon The emulator is running in the monitor; the debugger will 

accept commands. 

BusGmt The emulated processor has granted its bus to another device. 

Halted The emulated processor has entered a halted state. 

uP Idle The emulator processor is idle. 

Reset The emulated processor is being held in a reset state. 

AwtRst The emulator is awaiting a target system reset. 

Asleep The emulated processor is Asleep. 

SlowBus The emulated processor's bus is responding slowly or not at all. 

This is probably the result of many wait states or a handshake at 
an unimplemented address. 

SlowClk The emulated processor' s clock is running slowly or not at all. 

NotRdy The emulated processor's bus is being held in a "not ready" 

state. This is probably due to extended wait states or 
unimplemented memory. 

Unknown The emulator has entered an unknown state. If this occurs, you 

should attempt to reset the processor into the monitor. 

CMBWait The emulator is awaiting some action on its Coordinated 

Measurement Bus. 

TargRst The emulated processor is being held in a reset state by the 

target system. 
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TargPwr The target processor is not powered. 

Indicator Characters 

The Warning indicator (W) indicates that the program counter is not on a C source 
line boundary. The debugger displays a warning when it detects a breakpoint, an 
instruction halt, or an instruction error between Unes. 

The Log indicator (L) indicates that commands are being logged to a log fUe. 

The Journal indicator (J) indicates that everything appearing in the Joumal window 
is being written to a journal file. 

The Register indicator (R) indicates that a register variable is being used, but its 
lifetime is not known by the debugger. The debugger displays an R when the 
variable is referenced, indicating that the values being used for this variable may 
not be valid. 

CPU Emulated 

The CPU entry indicates which microprocessor is being emulated. 

Current Module 

The MODULE: entry names the current module (<module>). The current module 
is the module pointed to by the program counter. If the program counter points 
outside of the known code area associated with the program, this entry displays 
7777777. 

Last Breakpoint 

The BREAK # entry indicates the number of the last breakpoint that occurred, or 
(0) zero if execution was not terminated with a breakpoint. 

Trace Status 

The TRC:<Trc_status> entry indicates the status of the trace measurement 
function. The possible values for <Trc_status> are hsted on page 170 in the 
"Making Trace Measurements" chapter. 
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To display information about the debugger 
version 

• Select Help^General Topic ...^Interface Revision Information. 

Information about how this version of the debugger differs from previous versions 
is now included in the on-line help. This includes the information which was 
previously printed in the Operating Notice or the "Versions" chapter of the User's 
Guide. 
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Solving problems with the Interface 



If pop-up menus don't pop up 

When you hold the right mouse button down, a pop-up menu does not appear. 
Here are some things to check: 

CH Check that the mouse pointer is hand-shaped. 

Some areas of the screen do not have pop-up menus. 

n Check that your mouse buttons are not being redefined in your window manager 
resource file. Delete any redefinitions from the resource file. 

For example, it is very common for users of mwm to redefine the right mouse 
button to raise a window by changing the mouse button definitions in the .mwmrc 
file. The redefinition causes mwm to trap the right mouse button and not pass it 
through to the debugger. Deleting the redefinition will allow the button chck to 
pass through. 
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Loading and Executing Programs 

How to load a program into the debugger and control its execution. 
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Using a Hewlett-Packard C Cross Compiler 

Use the default compile mode when compiling your target programs for use with 
the debugger. The default settings generate executable files (.x file extension) in 
the HP-MRI IEEE-695 file format required by the debugger. The default option 
settings force a stack frame to be built for every function call, which is required for 

stack backtracing. 

The "Getting Started" chapter of the 68000 Family C Cross Compiler User's Guide 
gives an example of how to compile a simple program and execute it in the 
HP 64749/751/780/782 6833x/340/360 environment. 



Note Do not use the -h option when compiling and linking your program for the 

debugger. The -h option causes the compiler to generate HP 64000 file formats. 
Use the default settings which generate executable files in the HP-MRI IEEE-695 
file format required by the debugger. The debugger extracts all symbolic 
information from the executable (.x) file. 



Using Environment Dependent Fiies 

The HP B3640 Motorola 68000 Family C Cross Compiler provides environment 
dependent files that support the HP 64749/75 1/780/782 emulation environment. 
The debugger has the same simulated I/O capabilities as the HP 64000 Series 
emulators. The same environment dependent files are used for both the debugger 
and emulator environments. These environment dependent routines affect the 
following areas of C programming: 

• program setup 

• dynamic memory allocation 

• program input and output 



Note You may need to use the -r compiler option to compile with the correct default 

linker command files. 
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Note If you are using an HP Software Probe, use the 64749 environment dependent fUes. 



The "Environment Dependent Routines" chapter of the 68000 Family C Cross 
Compiler User's Guide describes the environment dependent routines supplied 
with the compiler. 

Using Optimizing lUlodes 

If you use the optimizing modes (-0 or -OT), function calls that do not have 
automatic variables may not have stack frames. As a result, the stack backtrace 
window will not contain entries for such functions. Additionally, the optimizing 
modes will cause the compiler to generate code which is not easily debugged. 



Note When initially compiling a program for the debugger, you should turn off all 

optimizations to avoid confusion when using the debugger. After program flow 
and aU basic algorithms have been debugged, you can recompile the program with 
all optimizations turned on. 

When you compile with aU optimizations on, one or more of the following 
problems may occur while using the debugger: 

• Target program execution in the debugger may not appear to correctly reflect 
the logical flow of the program. 

• The debugger may not stop execution at a high-level breakpoint or may stop 
execution at the wrong location in the program. 

• The debugger may not be able to display local variables. 



Forcing Variables to be Placed in Memory 

The default compiler settings automatically create register variables for statics and 
frequently used variables. Some debugger functions such as access breakpoints 
win not work with register variables. The compiler option -Wc, -F turns off the 
compiler's automatic creation of register variables, forcing the compiler to assign 
these variables to memory. This enables greater functionaUty of some debugger 
commands. After debugging your code, you can then recompile your code without 
these options for greater efficiency. 
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Using lUlatli Libraries 

Although FPU instructions can be executed in the target system, the 
debugger/simulator cannot execute these instructions. To generate code that wiU 
run interchangeably in both the debugger/emulator and debugger/simulator, use the 
C compiler's floating point library routines. These libraries contain routines that 
do not use FPU instructions, thereby allowing them to execute properly in both 
debugging environments. 

References 

The "Getting Started" chapter of the 68000 Family C Cross Compiler User's Guide 
gives an example of how to compile a simple program and execute it in the 
debugger environment. 

The "Command Syntax" chapter of the 68000 Family C Cross Compiler User's 
Guide gives detailed descriptions of compiler options. 

The "Environment Dependent Routines" chapter of the 68000 Family C Cross 
Compiler User's Guide describes the environment dependent routines supplied 
with the compiler. 

Using Microtec Language Tools 

The debugger is designed to work with the HP Advanced Cross Language System. 
However, you can also use the Microtec Research, Inc. language tools with the 
debugger. 

Microtec' s language tools are quite similar to the HP language tools. The input 
syntax and code generated by the HP and Microtec assemblers, linkers, and 
librarians are identical with few exceptions. 

The language tools available from Microtec are the incc68k C compiler, the 
ccc68k C++ compiler, the asm68k assembler, the lnk68k linker, and the lib68k 
librarian. 

Using tlie Microtec Commands 

For instructions on how to compile and assemble programs using the Microtec 
language tools, refer to Application Note for Hewlett-Packard 68xxx Product 
Interfaces and Microtec Research Inc. 68xxx Language Tools. This application 
note is available from your Hewlett-Packard sales representative. 
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Assembler Defaults 

You should be aware of these differences between asm68k and as68k: 

Command-line syntax. The differences are minor. See the on-line man pages 
for a description of the command-line options. 

Case sensitivity. as68k is case sensitive by default, asm68k is not. Use the 
command line flag "-fcase" to make asm68k case sensitive. 

Symbols in HP-MRI IEEE-695 files. The HP assembler places local symbols 
in the output object file by default, asm68k does not. Use the command Une flag 
"-fd' with asm68k to generate local symbols. 

The HP assembler places global symbols in the debug part by default. There is no 
way to do this with Microtec' s asm68k. This information is needed to correctly 
scope symbols. Thus you will find that some symbols may be incorrectly scoped 
with the Microtec assembler. 

Linker Defaults 

You should be aware of these differences between lnk68k and ld68k: 

Output file format. Id68k produces HP-MRl lEEE-695 by default. Ink68k 
products Motorola S-Records by default. To generate an HP-MRI IEEE-695 (.x) 
format absolute file, use the -H command Une option or -fi flag. 

Local symbols. Id68k provides local symbols in absolute file by default, but 
lnk68k does not. The command line flag -fi and option -H also set the d flag which 
wiU cause lnk68k to generate local symbols. 

Support files. Id68k and lnk68k have different default locations and 
environment variables used to locate linker command files and libraries. 

Librarian Defaults 

ar68k uses .a as the default hbrary suffix. hb68k uses .lib as the default library 
suffix. 
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The Microtec MCC68K Compiler 

mcc68k is very different from the HP compilers. Study the Microtec 
documentation if you need specific information about mcc68k. 
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Loading Programs and Symbols 

This section shows you how to: 

• Specify the location of C source files. 

• Load programs. 

• Load programs only (without symbols). 

• Load symbols only (without the program). 

• Load additional programs. 

• Specify demand loading of symbols. 



To specify the location of C source files 

• Before you start the debugger, set the HP64_DEBUG_PATH enviroimient variable. 

The location of C source files can be defined to the debugger with the UNIX shell 
variable HP64_DEBUG_PATH. If HP64_DEBUG_PATH is defined, the 
debugger first searches for the files in the path(s) specified in the variable, in the 
order in which they are listed. 

In addition to path names, you can place a percent sign (%) character in the 
HP64_DEBUG_PATH definition. The percent sign forces the debugger to search 
for files in their compile -time locations. (Compile-time paths are stored in the 
absolute file.) The search of these paths occurs at the point that the percent sign is 
found in the variable. For example, if the percent sign is first in the variable before 
any paths, the debugger will search for the file in the location recorded for it in the 
absolute file before checking the other locations specified by the 
HP64_DEBUG_PATH variable. 

If HP64_DEBUG_PATH is not defined, or HP64_DEBUG_PATH is defined, but 
the files were not found in the paths listed there, the debugger searches for source 
files in the following sequence: 
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1 their location at compile time (this information is recorded in the absolute file) 

2 the current directory (if the required source files are not found in their compile 
location) 



Example The shell variable definition: 

HP64_DEBUG_PATH=/users/proj/src: /users /pro j /my src 
export HP64_DEBUG_PATH 

causes the debugger to search paths for C source files in the following order: 

1 /users/proj/src 

2 /users/proj/mysrc 

3 the paths specified in the absolute file at compile time 

4 the current directory 

If you use the csh shell (most Sun systems), use setenv instead of export to set the 
variable. 



To load programs 

• When starting the debugger, enter the executable file name as the last term in the 
db68k command Une. 

$ db68k -e emul68k <abs_file> 
Or: 

• Select File^Load^Executable, then use the File Selection dialog box to select 
the executable fUe. 

Or: 

• Using the command line, enter: 

Program Load Default <file_name> 

When you load an absolute file using these commands, the debugger: 
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1 Removes all previous program symbols. 

2 Removes all previously set breakpoints. 

3 Resets the program counter (PC). 

4 Loads the full symbol set. 

5 Loads the new executable module. 

Absolute files contain executable object code. They must have a file name 
extension of .x. You do not need to specify the .x file extension when entering the 
absolute file name. 

The Program Load Default conmiand is equivalent to the Program Load New All 
Pc_Set command. 

Examples To load the executable file ecs.x: 

$ db68k -e emul68k ecs 

Or: 

Program Load Default ecs 



To load program code only 



• Select File^Load^Program Only then use the File Selection dialog box to 
select the absolute file. 

Or: 



• Using the command line, enter: 

Program Load New Code_only No_Pc_Set <absolute_name> 

Enter the name of the absolute file whose code is to be loaded, and press the 
<Return> key. 

The code image will be loaded without loading symbols or resetting the PC. 
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If you are re-loading a program, you may need to re-spedfy variables for the 
Monitor window. To re-load a program without clearing the Monitor window, 
enter: 

Program Load Append Code_onlY No_Pc_Set <absolute_name> 



To load symbols only 

• Use the -I option to the db68k command when starting the debugger. 

$ db68k -e einul68k -I <absolute_f ile> <RETURN> 
Or: 

• Select File— >Load— ^Symbols Only then use the File Selection dialog box to 
select the absolute file. 

Or: 

• Using the command line, enter: 

Program Load New SYmbols_only No_Pc_Set <absolute_f ile> 

Enter the name of the absolute file whose symbols are to be loaded, and press the 
<Retum> key. 

Only symboUc information is loaded from the absolute file. 

When joining an emulation session already in progress, or when continuing a 
previously locked session, the debugger will attempt to load the symbols from the 
last executable loaded, if you do not specify the name of an executable on the 
command line. 
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To load additional programs 

• Using the command line, enter: 
Program Load Append 

Select either AH, Code_Only, or Symbols_Only. Then, select either Pc_Set or 
No_Pc_Set. Finally, enter the name of the absolute file to be appended, and press 
the <Return> key. 

All both code and symbols are loaded. 

Code_Only only code from the absolute file is loaded. 

Symbols_Only only symbols from the absolute file are loaded. 

Pc_Set the program counter (PC) is set to the transfer address found in 

the absolute file. 

No_Pc_Set the program counter (PC) is not changed. 

When you append a program, it is loaded without deleting the existing program. 
The new symbols will be added in a tree with the executable file name as the root. 

Examples To append the program "module2.x" to the current program without setting the 

program counter: 

Program Load Append All No_Pc_Set module2 



To turn demand loading of symbols on or off 

• Select Settings^Debu^er Options and set the Demand Loading option. 

With demand loading, some symbol information is loaded on an as-needed, 
demand basis rather than during the initial load of the .x fUe. Demand loading lets 
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you load and debug programs that otherwise would not be loadable because of very 
large amounts of symbol information. 

Symbol information for global symbols, local symbols in the source module 
containing main, and local symbols in assembly modules are loaded during the 
initial load of the .x file. Local symbols in C source modules other than that 
module which contains main are loaded either when the user explicitly references 
the module or when the program is stopped with the program counter in the 
module. 

You can also use the -d option when starting the debugger to specify demand 
loading. The -doff option turns off demand loading. This option wil override the 
option in the startup file. 
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Stepping Through and Running Programs 

The various Program Run command options can be combined to make complex 
run-time control commands for your program. 

This section shows you how to: 

• Step through programs. 

• Step over functions. 

• Run from the current PC address. 

• Run from a start address. 

• Run until a stop address. 



To step through programs 

• Chck on the Step action key. 
Or: 

• Select Execution^Step^from PC. 

Or: 

• Using the command line, enter: 

Program Step 

And press the <Return> key. 

Your program executes one C source line (high-level mode) or one machine 
instruction (assembly-level mode) at a time from the address contained in the 
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program counter PC. When the program calls a function, stepping continues in the 
called function. 

You can specify a starting address with the Program Step command. You can also 
specify a step count to cause the debugger to step multiple lines or instructions in 
your program. 

The debugger updates the screen after each instruction or line is executed. The 
highlighted line in the Code window (which indicates the value of the program 
counter) is the location of the next hne to be executed. If a breakpoint is 
encountered, single-stepping is halted. 

You can also use function key F7 to single-step. 

If the debugger steps into an HP library routine, run until the stack level above the 
level of the Ubrary routine. Use the Program Run Until command or the Backtrace 
window pop-up menu. 



To step over functions 

• Chck on the Step Over action key. 
Or: 

• Select Execution^Step Over^from PC. 

Or: 

• Using the command line, enter: 

Program Step Over 
And press the <Retum> key. 

The debugger steps through the program one hne or one instruction at a time. 
However, if the debugger encounters a C function or assembly-level JSR or CALL 
instruction, it stops stepping, executes the JSR or CALL instruction, and then 
continues stepping when the called subroutine retums. 
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You can also use function key F8 to step over functions. 



To run from the current program counter (PC) 
address 

• Click on the Run action key. 
Or: 

• Select Execution^Run^from PC. 

Or: 

• Using the command line, enter: 

Program Run 

And press the <Return> key. 

The program runs until: 

• The program encounters a permanent or temporary breakpoint. 

• An error occurs. 

• You press <Ctrl>-C. 

• The program terminates normally. 

You can run from the current program counter address to resume program 
execution after the program has been stopped. 



To run from a start address 

1 Enter the start address into the entry buffer. 
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2 Select Execution^Run^from (). 

Or: 

• Using the command line, enter: 

Program Run From <start_addr> 

Type in the start address, and press the <Retum> key. 

The program runs until: 

• The program encounters a permanent or temporary breakpoint. 

• An error occurs. 

• You press <Ctrl>-C. 

• The program terminates normally. 

Running from a start address in high-level mode may cause unpredictable results if 
the compiler startup routine is bypassed. 



To run until a stop (break) address 

1 Enter the stop address into the entry buffer. 

2 Select Execution^Run^until () or click on the Run til () action key. 
Or: 

• Using the command line, enter: 

Program Run Until <break_addr> 

Type in the stop address and, optionally, a pass count, and press the <Return> key. 

The break address (<break_address>) acts as a temporary instruction breakpoint. It 
is automatically cleared when program execution is halted. 
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The pass count (<pass_count>) parameter specifies the number of times the break 

address is executed before the program is haked. For example, a pass count of 
three will cause the program to break on the fourth execution of the break address. 

Multiple break addresses are OR'ed. In other words, if you specify more than one 
break address, the program runs until either address is encountered. 



Note The debugger/emulator implements instruction breaks using software breakpoints. 

Therefore, break addresses carmot be specified for addresses in target ROM. 



Examples To run the program until either Une 20 or Une 90 is encountered, whichever occurs 

first. 

Program Run Until #20, #90 

To run from the current program counter address until the break address 
update_system is encountered twice: 

Program Run Until update_system %%2 

The Until option in the command sets a temporary breakpoint at address 

update_system. The pass count parameter %%2 specifies that the debugger is to 
stop program execution on the second access to address update_system. 
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Using Breakpoints 

The debugger implements access, read, and write breakpoints using analyzer 
hardware . 

The debugger implements instruction breakpoints using software traps. 

Note The debugger may or may not display the BKPT instruction used for the breakpoint 

in the assembly-level code window. This may cause a temporary incorrect 
disassembly of instructionsbeyond the breakpoint. 

This section shows you how to: 

• Set a memory access breakpoint (read, write, or either). 

• Set an instruction breakpoint. 

• Clear selected breakpoints. 

• Clear aU breakpoints. 

• Display breakpoint information. 



To set a memory access breakpoint 

• Enter the address (which may be a symbol) in the entry buffer. Select 
Breakpoints^Set and select Read, Write, or Read/Write. 

Or: 

• Using the command line, enter Breakpt, select the type of access to break on 
(Read, Write, or Access), enter the address of the memory location, and press the 
<Return> key. 

The access types have the following meanings: 
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Read break on read accesses. 

Write break on write accesses. 

Access break on either read or write accesses. 

Access breakpoints cause the debugger to halt program execution each time the 
target program reads from or writes to the specified memory location(s). Memory 
locations can contain code or data. 

The debugger uses the emulation analyzer to implement access breakpoints. The 
analysis hardware has eight single break resources and one range break resource. 
Each breakpoint command uses one or more of the analysis resources. 

The following commands each use one analysis break resource: 

• Breakpt Access <addr> 

• Breakpt Read <addr> 

• Breakpt Write <addr> 

The command Breakpt Access <addr> .. <addr> uses the one range 
break resource. 

The commands Breaicpt Read <addr> .. <addr> oi Breakpt Write 
<addr> . . <addr> use the analysis range resource and four analysis break 
resources. 

If you request more access breakpoints than there are available in the analysis 
hardware, the message Breakpoint limit exceeded will be displayed on your screen. 
If this happens, you must delete an existing analysis breakpoint before you can 
enter a new one. 

Due to the latency of the emulation analyzer, the processor will halt from 0 to 2 
instruction cycles after the breakpoint is detected. Due to the processor's prefetch 
feature, it is possible for hardware breaks to occur on addresses of instructions that 
are not executed. 



Note The emulator user interface may specify a trace that overrides a debugger access 

breakpoint. The debugger interface will set up the access breakpoint trace when a 
run or step command is issued only if the analyzer is not currently in use. Using 
both access breakpoints in the debugger and trace features in the emulator is not 
recommended. 
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Examples To cause execution to halt each time the program reads from or writes to the 

variable current_temp: 

Breakpt Access &current_temp 

To cause execution to halt each time the program reads from the variable 
current_temp: 

Breakpt Read &current_temp 

To cause execution to halt each time the program writes to the variable 
current_temp: 

Breakpt Write &current_temp 



To set an instruction brealtpoint 

• Position the mouse pointer in the code window over the Une at which you wish to 
set a breakpoint. Either click the right mouse button, or press and hold the right 
mouse button to display the Debugger Display pop-up menu and choose Set/Clear 
Breakpoint from the menu. 

Or: 

• Enter the instruction address into the entry buffer, then select 
Breakpoints^Set^Instruction (). 

Or: 

• Using the command line, enter: 

Breakpt Instr <addr> 

Enter the address of the instruction location, and press the <Return> key. 

The instruction breakpoint causes the debugger to halt program execution each 
time the target program attempts to execute an instruction at the specified memory 
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location(s). The debugger halts program execution before the program executes 
the instruction at the breakpoint address. 

If you specify a range, the debugger sets breakpoints on the first byte of each 
instruction within the specified range. 

Set breakpoints are marked with asterisks "*" in the code window. In the high-level 
mode, dots "." show the source lines associated with a breakpoint. 

Instruction breakpoints are implemented using the emulator's software breakpoint 
capabiUty. You can set at least 32 software breakpoints. If your HP 64700 firmware 
version is 4.0 or later, there is no limit on the number of breakpoints you can set. 
Breakpoints are implemented by replacing the program opcode with a BKPT 
instruction. Executing the BKPT instruction causes program control to be 
transferred to the emulation monitor, stopping the program. 

Because a BKPT instruction must replace the instruction at a memory location, 
software breakpoints can only be set in: 

• Emulation RAM. 

• Emulation ROM. 

• Target system RAM. 

Software breakpoints cannot be set in target ROM. Software breakpoints caimot be 
used to detect data accesses. 



Note Setting an instruction breakpoint in a memory area mapped as emulation ROM is 

allowed because the debugger can write to emulation ROM addresses. 
Setting an instruction breakpoint will fail if the BKPT opcode is not successfully 
written at the specified address. This precludes setting an instruction breakpoint in 

an area of target memory made up of ROM chips or in a guarded memory area. 



Note The default setting of the debugger option Align_Bp (align breakpoint) is oFF. 

Setting the option to On causes breakpoints to be aligned based on the assembly 
language instructions found in memory at the time the breakpoints are set. If 
multiple breakpoints exist in the same program area, their alignment may be 
incorrect. Make sure the Align_Bp option is set to oFF to prevent breakpoint 
aligrmient problems. See the "Configuring the Debugger" chapter for more 
information. 
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Example 



To set an instruction breakpoint at line 82 of the current module: 
Breakpt Instr #82 



Example 



To set a breakpoint for a C++ object instance 

Use the dot or arrow operator to specify the object and the member function. 

This allows you to set a breakpoint for a member function only when it is invoked 
for a given object or instance. 

To break when function cfunc is invoked by object instance cobjl, enter: 
Breakpoint Instr cobjl. cfunc 

To do this the hard way, you could enter: 

Breakpoint Instr C : : cf unc\@entry; when (C : : cf unc\this== 
&cob j 1 ) 



To set a breakpoint for overloaded C++ functions 

• To set a breakpoint at one of the functions when you know the argument type, 
supply the argument type following the function name. 



• To set a breakpoint at one of the functions when you don't know which argument 
type you want, just use the name of the function. The debugger will hst the choices 
with a menu in the Journal window. 



Example 



To set a breakpoint for the function print (which is not in a class) for float 
arguments, enter print (float ) in the entry buffer and select 
Breakpoints^Set (). 
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Another way to set a breakpoint for the function print is to enter print in the 
entry buffer, select Breakpoints— >Set (), then type the number of "print (float);" 
from the menu in the Journal window. 



To set a breakpoint for C++ functions in a class 

• Set a breakpoint for the C++ class. 



Examples To set breakpoints for all member functions of the class classname, enter 

"classname::" in the entry buffer, then select Breakpoints^Set () from the menu 
bar. 

Or, using the command line, enter: 
Breakpoint Instr classname:: 



To clear selected breakpoints 

• Position the mouse pointer in the Code window over the line at which you wish to 
clear a breakpoint. CUck the right mouse button. 

Or: 

• Position the mouse pointer in the Code window over the Une at which you wish to 
clear a breakpoint. Hold the right mouse button and select Set/Clear Breakpoint. 

Or: 

• Position the mouse pointer in the Breakpoint window over the breakpoint you wish 
to clear. Hold the right mouse button and select Delete Breakpoint. 

Or: 
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• Place the breakpoint address in the entry buffer, then select Breakpoints^Delete 
(). 

Or: 

• Using the command line, enter: 

Breakpt Delete <brkpt_nmbr> 

Enter the breakpoint number, and press the <Return> key. 

The debugger assigns a breakpoint number to each breakpoint. The debugger uses 
this number to remove the breakpoint. 

The <brkpt_nmbr> is the number of the breakpoint displayed in the debugger 
breakpoint window. Enter a range of breakpoint numbers 
(<brkpt_nmbr>..<brkpt_nmb]>) to remove more than one breakpoint at a time. 
When you delete a breakpoint, all following breakpoints are renumbered. 



Examples To delete breakpoint number 1: 

Breakpt Delete 1 



To clear all breakpoints 

• Select Breakpoints^Delete All. 

Or: 

• Select Delete All Breakpoints from the Breakpoints window pop-up menu. 
Or: 
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• Using the command line, enter: 

Breakpt Clear_All 
And press the <Return> key. 



To display breakpoint information 

• Select Window^Breakpoints. 

Or: 

• Using the command line, enter: 

Window Active Breakpoint 
And press the <Retum> key. 



The debugger displays the breakpoint window when: 

• You enter a breakpoint command. 

• You execute the Window Active Breakpoint command. 

• You use function keys F1/F2 to activate next/previous windows. 

The Breakpoint window temporarily overlays the top portion of the screen. 

When made active, this window displays breakpoint information including: 

• Breakpoint number. 

• Breakpoint address. 

• Name of the module or function containing the breakpoint (in high-level 
mode). 

• Module hne number (in high-level mode). 

• Breakpoint type. 

• Command arguments entered with the breakpoint command. 
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The following paragraphs describe each field in the breakpoint window. 
Breakpoint number 

The debugger assigns a breakpoint number (#) when you execute a breakpoint 
command. The debugger uses this number as a label to reference or clear each 
breakpoint. 

Breakpoint address 

The breakpoint address (ADDRESS) shows the memory location of the breakpoint. 
The debugger displays the address as a hexadecimal value. 

lUloduie/function 

The module/function field (MOD/FNCT) displays either the name of the module 
containing the breakpoint or the name of a function if you qualified the breakpoint 
with a function name. If you specify a module name with a breakpoint command, 
the name must be followed by a line number (for example: main \ #80). The field 
width is eight characters. The debugger truncates field entries greater than eight 
characters in length to eight characters. 

Line number 

The line number entry (LINE) displays a module line number if you set a 
breakpoint in a high-level module. If the compiler did not generate executable code 
for the C statement at the line number specified, the debugger examines the source 
code and sets a breakpoint on the next line number for which the compiler 

generated executable code. 

In the code window, the debugger places asterisks beside all line numbers that are 
associated with breakpoints. The debugger places period symbols (.) beside line 
numbers that are specified as breakpoints, but have no code associated with them. 

Breakpoint type 

The breakpoint type (TYPE) describes what type of breakpoint is set: instruction, 
read, write, or access. In assembly-level mode, the debugger sets instruction 
breakpoints on microprocessor instruction addresses. In high-level mode, the 
debugger sets instruction breakpoints on source hne numbers. The debugger flags 
instruction breakpoints withM (assembly-level) ot/H (high-level). When 
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switching between modes, these flags are useful for differentiating between the 
different types of breakpoints. 

Command argument 

The debugger records arguments (COMMAND ARGUMENT) in the breakpoint 
window as you entered them on the command line. Line numbers, addresses, 
symbol names, and macro names all appear in this field. For more information 
about breakpoints, see the specific breakpoint command descriptions in the 
"Debugger Commands" chapter. 
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To halt program execution on return to a stack 
level 

• Select Run UntU Stack Level from the Backtrace window pop-up menu. 
Or: 

1 Set a stack level breakpoint. 

2 Run the program. 

3 If desired, delete the breakpoint that was just encountered. 



Example Assume that you want to run the program until it retums to the main( ) function. 

You can determine where to set a breakpoint on return to main by using the stack 
level information in the backtrace window (you may have to activate this window 
in order to see the information in it). 

There is a number next to the function main() in the backtrace window. This is the 
current stack level of main( ). This is the address of the machine level instruction 
immediately following the call to initialize_system. 

Place the mouse pointer over the Une in the backtrace window that Usts "main." 
Hold the right button and select Run Until Stack Level. 

Or, using the command line and assuming main() is at stack level 1, enter: 

Breakpoint Instr @1 

This command will cause program execution to stop when the program returns to 
the function main. The at sign (@) is a debugger operator that causes the debugger 
to interpret the number 1 as a stack level. 

Executing the Breakpt Instr command causes the debugger to update and display 
the Breakpoint window. The breakpoint you just entered is shovm in the 
Breakpoint window. Now use the appropriate commands to run the program and 
delete the breakpoint. 
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Restarting Programs 

This section shows you how to: 

• Reset the processor. 

• Reset the program counter to the starting address. 

• Reset program variables. 



To reset the processor 

• Select Execution^Reset to Monitor. 

Or: 

• Using the command line, enter: 

Debugger Execution Reset_Processor 
And press the <Retum> key. 

Resetting the processor resets the microprocessor to its initial state and leaves the 
microprocessor running in the monitor. 

Resetting the processor executes a physical reset of the processor and any target 
hardware connected to the reset hne. Values for the SIM module registers wUl be 
copied from the corresponding configuration values upon entry into the monitor. 
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To reset the program counter to the starting 
address 

• Select Execution^Set PC to Transfer . Or, 

• Using the command line, enter: 

Program Pc_Reset 
And press the <Retum> key. 

The program counter is reset to the transfer address of your absolute file. The next 
Program Run or Program Step command entered without &from address will restart 
program execution at the beginning of the program. 



To reset program variables 

• Reload your program. 

Memory is not reinitiahzed when you reset the processor or reset the program 
counter. Therefore, program variables are not reset to their original values. To 
reset program variables after resetting the processor or program counter, reload 
your program. 

For faster loading, you can load only the program code. The debugger retains 
symbol information. You do not have to reload symbol information if symbol 

addresses have not changed. 

For information on loading programs, refer to the previous "Loading Programs and 
Symbols" section. 



Examples To save the current memory contents and register values in file "sessionl.sav": 

Debugger Execution Save_State sessionl 
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Loading a Saved CPU State 

State files are used to save the current CPU state (memory image and register 
values) of a debug session. Though state files can only be created from within a 
debugger/simulator session, you can use them to restore a CPU state in either a 
debugger/simulator or debugger/emulator session. 

This section shows you how to: 
• Load a saved CPU state. 



To load a saved CPU state 

1 Ensure that the emulator is configured correctly for the code you are restoring and 
that debugger parameters that affect the emulator (such as breakpoints) are set to 
appropriate values. 

2 Load symbolic information from same absolute file that was in the simulator when 
the CPU state was saved. (The debugger/simulator does not save symbolic 
information.) 

3 Load the state file. Using the command line, enter: 
Debugger Execution Load_State 

Enter the name of the file from which the CPU state should be loaded, and press 
the <Retum> key. 

The memory contents and register values saved with the debugger/simulator 
Debugger Execution Save_State command are restored from the specified state file. 
If you do not specify a file name, the debugger uses the default file db68k.sav. 

The Debugger Execution Load_State command does not restore breakpoints, 
macros, or pseudoregister values. After redefining any breakpoints, macros, and 
pseudoregisters, you are ready to continue your debugging session. 
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If your program uses simulated I/O, it may not function properly on entering the 
debugger/emulator because the simulated I/O initiaUzation may not have occurred. 

Examples To restore memory contents and register values saved in state file "sessionl .sav" : 

Debugger Execution Load_State sessionl 
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Programming Flash Memory 

If you are using the HP Software Probe, you can program or erase flash memory 
parts. 

This section shows you how to: 

• Program a flash memory part 

• Erase a flash memory part 



Supported Parts 

A partial hst of the parts which you can program and the programming algorithms 
to use when programming them is included in the on-line help for the FLASH 
Operations dialog box. 

Selecting either File^Load^FLASH from File.... or Modify^FLASH Erase 

.... will pop up a dialog box similar to the following: 
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To program a flash memory part 

1 Open the FLASH Operations dialog by selecting File^Load^FLASH from 
File.... 

2 Select the algorithm to use when programming the part, the width of the part, and 
the width of the processor data bus connected to the part. 

3 Select a data fUe. 

4 Click on the OK button (to program the part and close the dialog) or the Apply 
button (to program the part and keep the dialog open). 



To erase a flash memory part 

1 Open the FLASH Operations dialog by selecting Modify^FLASH Erase .... 

2 Select the algorithm to use when erasing the part, the width of the part, and the 
width of the processor data bus coimected to the part. 

3 Select the sectors to erase. 

Some devices may allow a fuU erase, a sector erase, or both. These selections 
will be "grayed out" as appropriate for the algorithm selected. 

4 Click on the OK button (to erase the part and close the dialog) or the Apply button 
(to erase the part and keep the dialog open). 



See Also 



The on-line help for the FLASH Operations dialog box. 



See Also 



The on-line help for the FLASH Operations dialog box. 
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To program or erase a flash memory part using a 
command file 

If you will be programming a large number of flash memory parts — on a 
production line, for example — you can make the job easier by placing the 
programming commands in a command file. 

1 Turn on file logging by selecting FUe^Log^Record Commands.... 

2 Program a part using the FLASH Operations dialog box. 

3 Stop logging commands by selecting File^Log^Stop Command Recording. 

4 If necessary, edit the command file to remove unwanted commands. 

5 Replay the stored commands in one of the following ways; 

• Replay the command file by selecting File^Log^Playback.... 

• Run the debugger in batch mode with the -c <command_file> option. 

• Program an action key to run the command file. 

See Also The "Using Macros and Command Files" chapter in this manual. 
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Accessing the UNIX Operating System 

This section shows you how to: 

• Fork a UNIX shell. 

• Execute a UNIX command. 



To fork a UNIX shell 



• Select File^Term. 

A terminal emulation window wiU be created. 
Or: 



• Using the command line, enter: 

Debugger Host_Shell 
And press the <Retum> key. 

The Debugger Host_Shell command lets you temporarily leave the 
debugging environment by forking a UNIX shell. The shell created is whatever the 
shell variable SHELL is expanded to. In this mode, you may enter operating 
system commands. 

The Debugger Host_Shell command does not end the debugger session; it suspends 
program operation. To return to the debugger, enter <Ctrl>-D or type exit at the 
UNIX prompt, and press the <Return> key. 
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To execute a UNIX command 

• Using the command line, enter: 
Debugger Host_Shell 

Type in the UNIX command, and press the <Retum> key. 

When using the graphical interface, a terminal emulation window will be opened 
and the UNIX command will be executed in that window (as specified by the 
"sheUCommand" X resource). 

When using the standard interface, stdout from the command is written to the 
journal window, stderr is not captured. Commands writing to stderr will corrupt 
the display. Interactive UNIX commands cannot be used in this mode. 



Examples To display the current working directory, enter: 

Debugger Host_Shell pwd 
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Using the Debugger and the Emulator Interface 

The debugger and the emulator interface can use the emulator hardware at the same 
time. 

You should be aware of a few inconsistencies between the emulator and the 
debugger interfaces: 

• Modifying registers in one interface wUl not affect the register display in the 
other interface. 

• Loading an executable file in the debugger interface will set the program 
counter to the transfer address by default. Loading an executable in the 
emulator interface does not set the program counter. 



To start the emulation interface from the 
debugger 

Proceed with your debugging session until you get to the point where you need to 
use an emulator analysis feature. 

• If you are using the graphical interface, choose 
File^Emul700^Emulator/Analyzer. 

• If you are using the standard interface, enter 

Debugger Host_Shell 

Then, at the operating system prompt, type: 

emul7 00 <emulator_name> 

When you are done using the emulator, enter end then exit to retum to the 
debugger's standard interface. 
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Using the Debugger with the Branch Vaiidator 

The Hewlett-Packard Branch Vahdator (BBA) is an interactive tool that helps you 
rapidly determine which branches of a program have not been taken. With the 
missed branches identified, you can modify your regression tests to ensure software 
reliability. 

The branch analysis information is collected by C programs that have been 
compiled using the bbacpp preprocessor. 



To unload Branch Validator data from program 
memory 

• Select File^Store^BBA Data .... Then choose a file name from the File 
Selection dialog box. 

Or: 

• Using the command line, enter: 

Memory Unload_BBA All 
And press the <Retum> key. 

This command unloads branch analysis information associated with all absolute 
files loaded. 

The default file name is bbadump.data. 

The BBA preprocessor (-b option) must be used at compile time in order for this 
information to exist in program memory. 

Once this information has been unloaded, it can be formatted with the BBA report 
generator, bbarep (see the HP Branch Validator for AxLS C User's Guide). 
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Viewing Code and Data 

How to find and display source code and memory contents. 
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Using Symbols 

This section shows you how to: 

• Add a symbol to the symbol table. 

• Display symbols. 

• Delete a symbol from the symbol table. 



To add a symbol to the symbol table 

• Using the command line, enter: 
Symbol Add 

Enter the symbol data type, the symbol name, and optionally the base address and 
the initial value; then, press the <Return> key. 

Two types of symbols can be added: 

• Program symbols, which are identical to variables defined in a C or assembly 
program. These symbols must be given base addresses. 

• Debugger symbols, which may be used to aid and control the flow of the 
debugger. These symbols are specified without a base address, and only 
debugger commands and C expressions in macros can refer to them. They 
carmot be referenced by the program in target memory. 

Example To add a program symbol of type int (default) as an aUas for "num_checks", enter 

the following: 

Symbol Add no Address &num_check:s Fill_Mem -1 

The "Fill_Mem -1" command places the value -1 in num_checks. Notice that the 
Monitor window is not updated to reflect that change. 



116 



Chapter 4: Viewing Code and Data 
To display symbols 



To display symbols 

• Select Display^Symbol () to display information about the symbol in the entry 
buffer. 

Or: 

• Using the command line, enter: 
Symbol Display Default 

Enter the symbol, module, or function name; then, press the <Retum> key. 

Symbols and associated information are displayed in the journal window. 

When displaying a symbol in the current module, the debugger looks for the 
symbol in the current module. If there is no module qualifier, all symbols with the 
specified name will be displayed, including global symbols and symbols local to 
the module. 

The wildcard character * may be placed at the end of a symbol name to represent 
zero or more characters. If used with no symbol name, * is treated the same as \ 
that is, all symbols are displayed. 



Examples To display the symbol 'update_sys' in the current module: 

Symbol Display Default update_sys 

Symbol Display Default update_sys 

@ecs\\update_sys : Type is High level module. 

Code section = 00001436 thru 00001C21 

To display all symbols in module 'update_sys': 
Symbol Display Default update_sys\ 

> Symbol Display Default update_sys\ 
Root is: update_sys 

@ecs\\update_sys : Type is High level module. 

Code section = 00001436 thru 00001C21 

update_sys\update_system 

: Type is Global Function returning void. 
Address = 00001436 thru 00001513 

update_system\ref resh 
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: Type is Local int. 

Address = Frame + 8 
update_system\interval_complete 

: Type is Local int. 

Address = Frame + 12 



To display symbols in all modules 

• With "\" in the entry buffer, select Display^Symbol (). 
Or: 

• Using the command line, enter: 

Symbol Display Default \ 



To delete a symbol from the symbol table 

• Using the command line, enter: 

Symbol Remove <symb_name> 

Enter the symbol, module, or function name; then, press the <Retum> key. 

The specified symbols are removed from the symbol table. Only program symbols 
and user-defined debugger symbols can be deleted from the symbol table. 

Examples To delete the symbol "counter" in function "update_system": 

Symbol Remove update_system\counter 

To delete all symbols in module "update_sys": 
Symbol Remove update_sys\ 
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To delete all symbols in all modules: 
Symbol Remove \ 
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Displaying Screens 

A debugger screen is what you see in the display area. Each debugger screen may 
contain one or more debugger windows. A debugger window is a predefined 
physical area on the screen containing specific debugger information. 

The debugger has three predeiined screens. Each predefined screen has a 
corresponding name and number. The predefined screens and their associated 
names and numbers are Usted below: 

Screen Name Screen Number 

High-level screen ^ 
Assembly-level screen 2 
Standard I/O screen ^ 

This section shows you how to: 

• Display the high-level screen. 

• Display the assembly level screen. 

• Switch between the high-level and assembly screens. 

• Display the standard I/O screen. 

• Display the next screen (activate a screen). 

High-Level Screen 

The debugger automatically displays the high-level screen when an executable (.x) 
file containing the C function main() is loaded from the UNDC command line with 
the db68k command. This screen has nine windows: 

• journal 

• code 

• monitor 

• backtrace 

• status 

• breakpoint 

• error 

• help 
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• view 

The high-level screen displays high-level source code and stack backtrace 
information including the calUng sequence of functions and function nesting levels. 

Assembly-Level Screen 

The debugger automatically displays the assembly-level screen when an executable 
(.x) file is loaded from within the debugger or the executable file does not contain 
the C source function main(). This screen has ten windows: 

• journal 

• code 

• monitor 

• register 

• stack 

• status 

• breakpoint 

• error 

• help 

• view 

The assembly-level window displays assembly-level code and processor register 
and stack information. 

Standard I/O Screen 

The debugger displays the standard I/O screen when your program requests 
interactive input from the standard input device (stdin), or directs output to the 
standard output device (stdout). It may also be displayed using the F6 function 
key. This screen has five windows: 

• status 

• breakpoint 

• error 

• help 

• view 

You can also access the standard I/O screen as a window (window No. 20). 

The standard I/O window emulates a dumb terminal. It can be moved about the 
display, but it can be no larger than 24 rows by 80 columns. 
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To display the high-level screen 

• Select Settings^High Level Debug. 

Or: 

• Using the command line, enter: 
Window Screen_On High_Level 



To display the assembly level screen 

• Select Settings^Assembly Level Debug. 
Or: 

• Using the command line, enter: 

Window Screen_On Assembly_Level 



To switch between the high-level and assembly 
screens 

• Press the F3 function key. 
Or: 
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• Using the command line, enter: 

Debugger Level 

You can also use the Window New and the Window Active commands to display a 
different screen. 



To display the standard I/O screen 

• Press the F6 function key. 
Or: 

• Select Window^Simulated lO. 

Or: 

• Using the command line, enter: 

Window Screen_On Stdio 

The standard I/O screen is displayed when your program requests interactive input 
from the standard input device (keyboard) or when your program writes 
information to the standard output device. 



To display the next screen (activate a screen) 

• Press the F6 function key. 
Or: 
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• Using the command line, enter: 

Window Screen_On Next 

The next higher-numbered screen will be displayed. Either the high-level or the 
assembly-level screen will be displayed, not both. 

The debugger screens are numbered as follows: 

Screen Name Screen Number 

High-level screen 1 

Assembly-level screen 2 

Standard I/O screen 3 

User-defined screens 4-256 
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Displaying Windows 

This section shows you how to: 

• Change the active window. 

• Select the alternate view of a window. 

• Set the cursor position for a window. 

A debugger window is a predefined physical area on the screen. The debugger has 

18 predefined windows. Each window displays information specific to its 
associated name (for example, the breakpoint window displays breakpoint 
information). 

Each of the 18 predefined windows has a corresponding name and number. All 
windows (except the log file and joumal file windows, which are files) also have an 
associated screen number. The following table hsts the predefined windows and 
their associated names and numbers. 
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Window Name Window Screen 

Number Number 



journal (high-level) 


1 


1 


code (high-level) 


2 


1 


monitor (high-level) 


3 


1 


backtrace 


4 


1 


status (high-level) 


5 


1 


journal (assembly-level) 


10 


2 


code (assembly-level) 


11 


2 


monitor (assembly-level) 


12 


2 


register (assembly-level) 


13 


2 


stack 


14 


2 


status (assembly-level) 


15 


2 


standard VO 


20 


3 


view 


24 


1,2,3 


breakpoint 


25 


1,2,3 


error 


26 


1,2,3 


help 


27 


1,2,3 


log fUe 


28 


none 


journal file 


29 


none 



The code window displays C source code in high-level mode. The code window 
displays disassembled machine code in assembly-level mode. The C source code 
that generated the assembly code can be interleaved with the assembly-level code. 

When disassembled code is displayed, the address and machine code of a 
disassembled instruction are displayed on the left side of the window as 
hexadecimal values. For instructions over 6 bytes in length, bytes 7 through n are 
replaced by ellipsis (...). 

The stack window displays the stack beginning at the memory location pointed to 
by the debugger stack pointer @SP. This window is available only within the 
assembly-level screen. 
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To change the active window 

• Use the command select mouse button to click on the border of the window you 
wish to activate. 

Or: 

• Select the window you want to make active from the Windows menu. 
Or: 

• Use the command line to select a window: 
Window Active <window> 

where <window> is the name of the window to be made active, and press the 
<Retum> key. 

The debugger uses a highlighted or thick border for the active window. The cursor 
keys, scroll bar, and function key F4 (select the alternate display) only operate in 
the active window. 

If you are using a terminal without graphics capabihties, the active window is 
indicated by single dashes around the border (other windows all have borders of 
equals signs). 

The window number is displayed in the upper right border of the window. 

Examples To make the high-level backtrace window active: 

Window^Baclctrace 

Or: 

Window Active High_Level Backtrace 

To make the breakpoint window active: 
Window Active Breakpoint 
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To make user window 57 active: 
Window Active User_Window 57 



To select the alternate view of a window 

• Click on the border of the active window with the command select mouse button. 
Or: 

• Press the F4 function key. 
Or: 

• Using the command line, enter: 

Window Toggle_View 
Or: 

• Using the command line, enter: 

Window Toggle_View <Window> 

where <Window> is the name of the window whose alternate view is to be 
displayed, and press the <Return> key. 

The typical default altemate view of a window is an enlarged view of the window, 
letting you view more information. Repeating the command switches between the 
normal view and the altemate view of the active window. 

Example To display the alternate view of the high-level code window: 

Window Toggle_View High_Level Code 
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To view information in the active window 

• Use the scroll bar. 
Or: 

• Use the cursor control keys. 

Press the <Up> or <Down> cursor key to move up or down in the window one line 
at a time. 

Press the <Page Down> (<Next>) or <Page Up> (<Prev>) key to move the 
window one-half of the window length at a time. 

Press the <Home> or <End> (<Shift> <Home>) key to position the window at the 
beginning or end of the information displayed in the window. 

Type <Ctrl>-F or <Ctrl>-G to shift the contents of the active window to the right 
or left. 

The following table describes the functions of the cursor control keys in the active 
window and the command line window. 
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Key Description 

Move to right in data field of command. 
Highlight token to the right in status line window. 

<— Move to left in data field of command. 

Highhght token to the left in status line window. 

T Move up one line in window. 

4- Move down one line in window. 

P r e V Move up one half window. 

Next Move down one half window. 

Home Move to the top of the active window (except stack window). 

End (Shift Home) Move to bottom of window (except for stack window). 

Insert char Put keyboard in insert mode for editing data field of command. 

Delete char Delete character within data field of command. 

Undo Back tab. 



The Home and End (Shift-Home) keys have additional functions when used with 
the code and stack windows. The following table describes how the Home and End 
(Shift-Home) keys work in these active windows. 
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Active Window 


Home Key 


End Key 


Code 


Move to top of module 


Move to bottom of module 


Stack 


Move to current stack pointer (SP) 


Move to current frame pointer (FP) 



To view information in the "More" lists mode 

If the "—More-" prompt is printed at the bottom of a window, the debugger is 
waiting to display more than one screen of information. 

• Press the space bar to display the next screen of information. 

• Press the <Return> key to display the next Une. 

• Press "Q" to end the "More" display. 

If you try to enter a command while the debugger is displaying the "-More-" 
prompt, the command will not be executed until the "More" display has ended. 

You can turn the "More" list mode off or on with the Settings^Debugger 
Options dialog box. 

For more information, see your operating system documentation on the more 
command. 



To copy window contents to a file 

• Select File^Copy Windows. 

Or: 
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• From the command line, enter the following commands: 

File User_Fopen Append 99 File <file_name> 
Expression Fprintf 99, "%vi" , <window_number> 
File Window_Close 99 



To view commands in a separate window 

• Select Window^Journal Browser-^Start. 

Journal output — the commands and miscellaneous information usually displayed in 
the Joumal window — will be displayed in a separate browser window. 

You may start several nested browser windows. 

Use End to end output to the current browser window without closing the window. 
Selecting Restart has the effect of an End followed by a Start. Use NextNCmds 
to record the next n commands in a browser window (for example, to record 
commands to use for an action key). 
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Displaying C Source Code 

This section shows you how to: 

• Display the C source code. 

• Find first occurrence of a string. 

• Find next occurrence of a string. 



To display C source code 

1 Display the high-level screen (see the instructions in the previous "Displaying 
Screens" section). 

2 Display source code at the location in the entry buffer by selecting 
Display^Source (). Or cUck on the Disp Src () action key. 

Or, using the command line, enter: 

Program Display_Source 

Enter the line number or function name of the code you wish to display, and press 
the <Return> key. 

Examples To display the C source code at line number 1 (in the current module): 

Program Display_Source #1 

To display the C source code at function main: 
Program Display_Source main 

To display C++ source code at overloaded C++ function cfunc, you can either give 
the name of the function and select the definition from a menu, or you can specify 
the definition by entering the argument type: 

Program Display_Source cfunc (float) 
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To find first occurrence of a string 

1 Display the high-level screen (see the instructions in the previous "Displaying 
Screens" section). 

2 Enter the string in the entry buffer. 

3 Select Display^Source Find Fwd () or Display^Source Find Back (). 

Or, using the command line, enter: 

Program Find_Source Occurrence <Direction> 

Select either Forward or Backward as the direction, enter the Une number or string 
you wish to find, and press the <Return> key. 



Example To find the first occurrence of the string "main": 

Program Find_Source Occurrence Forward main 



To find next occurrence of a string 



• Select Display^Source Find Again. 

Or: 

• Using the command line, enter: 

Program Find_Source Next <Direction> 

Select either Forward or Backward as the direction, and press the <Return> key. 



Example To find the next occurrence of a string: 

Program Find_Source Next Forward 
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Displaying Disassembied Assembiy Code 



To display assembly code 

• Select Settings^Assembly Level Debug. 
Or: 

• Using the command line, enter: 

Window Screen_On Assembly_Level 

The Code window will show disassembled insructions. 
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Displaying Program Context 

This section shows you how to: 

• Set current module and function scope. 

• Display current module and function. 

• Display debugger status. 

• Display register contents. 

• List all debugger registers. 

• Display the function calling chain (stack backtrace). 

• Display all local variables of a function at the speciiied stack (backtrace) level. 



To set current module and function scope 



• Select File^Context^Symbols enter the module or function name in the 
dialog box, and click on the OK pushbutton. 



Or: 



• Using the command line, enter: 

Program Context Set 

Enter the module or function name, and press the <Return> key. 

The module and function scope is used by the debugger to uniquely identify 
symbols. For example, several functions may have local variables with the same 
names. When you use that variable name without naming the function, the 
debugger assumes you mean the variable in the current module or function scope. 
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Examples To select module "update_sys" as the current module: 

Program Context Set update_sys 

To select function "update_sys\graph_data" as the current function: 
Program Context Set update_sys\graph_data 

To set the program context to the module at which the program counter is pointing: 
Program Context Set 



To display current module and function 

• Select Display^Context. Click on the Done pushbutton when you wish to stop 
displaying the information. 

Or: 

• Using the command line, enter: 
Program Context Display 

The current module, function, and line number are displayed in the journal window. 



To display debugger status 

• Select Window^Status. 

Or: 

• Using the command line, enter: 

Debugger Execution Display_Status 
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The following infonnation is displayed in the view window (which temporarily 
overiays the top portion of the screen): 

• Product version. 

• Current working directory. 

• Current log file in use. 

• Current journal file in use. 

• Startup file used. 

The view window is also used to display trace data and information about trace 
command or event status. When trace data is displayed, a trace status character 
may be displayed in front of the trace Une. The following table defines the trace 
status characters. 



Trace List Status Characters 



Character Description 

* The indicated trace line is the trigger condition. 

+ The indicated trace line is in the middle of a C statement, that 

is, not the first assembly language statement in the C source 
statement. 

! The data in the trace buffer line does not match the data in 

memory. 

? The trace Une may be a prefetch. 



To display register contents 

• Select Window^Registers 

Or: 
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• Select Modify^R^ster..., click Recall to choose the register from a list of 
register names, and click Read Current Register Value to display the register 
value. 

Or: 

• Using the command line, enter: 

Window Active Assembly Registers 

The register window shows the current values of the microprocessor's registers and 
several debugger variables. The microprocessor register values are labeled with 
their standard names. The debugger displays aU values in hexadecimal format 
unless otherwise noted. 

If you are running just the debugger the Registers window is available only within 
the assembly-level screen. If the emulator/analyzer graphical interface is active, 
Window^Registers will display registers in the emulator window. 

The information displayed in the register window varies with different 
microprocessors. See the "Registers" chapter and page 138 for information about 
the registers and pseudoregisters which you can display using expression 
commands. 



To list all registers 

• Using the command line, enter: 

Symbol Display Reserved_Symbols 

A list of all the registers and pseudoregisters supported by the debugger will be 
displayed in the Journal window. 

This command is useful if you want to know what registers are supported by the 
debugger, or if you need to find the sizes of various registers. 



139 



Chapter 4: Viewing Code and Data 

To display the function caiiing chain (stack backtrace) 

See Also Many of the registers are described in the "Registers" chapter. 



To display the function calling chain (stack 
backtrace) 

• Select Window^Backtrace. 
Or: 

• Using the command line, enter: 

Window Active High_Level Backtrace 

The backtrace window displays the function calling chain, from the compiler 
startup routine to the current function in high-level mode. 

This window displays (from left to right): 

• Function nesting level. 

• Retum address to the calling function. 

• Frame status character. 

• Module containing the function. 

• Function name. 

Function Nesting Level. The nesting level of the current function is always 0, 
the calling function always 1, etc. 

You may reference the nesting level when setting a breakpoint. For example, to 
cause the program to execute until it returns to the second nested function, enter the 
command: 

Program Run Until @2 

Another way to execute until a stack level is reached is to choose Run Until Stack 
Level in the Backtrace window pop-up menu. 

Return Address. The retum address field displays the retum address of the 
calling function. 
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Frame Status Character. One of several characters immediately precedes a 
function name in the backtrace window. These frame status characters and their 
descriptions are listed in the table below. 

Character Description 

Space The debugger is executing within a function. 

: The program counter is at a label. Typically, this is an assembly 

language function point. 

* The function has been entered, but the function prolog has not 

been executed. The debugger cannot locate local symbols in the 
function until the prolog has been executed. 

? The frame is questionable. For example, this is displayed when 

a function has been stripped of debug information. 

! The frame is not vahd. 

I The debugger is at the start of an interrupt routine. 

+ The debugger is executing an interrupt routine. 



Module Name. If the function is in a known module, the backtrace window 
displays the module name. If the program counter is pointing to an address that is 
not contained in a module known to the debugger, the module field in the backtrace 
window displays a string of question marks (???????). 

Function Name. If the return address of a function is inside a known function, 

the debugger displays the function name. If the address is outside of all known 
functions, the function field in the backtrace window will display <unknown>. 
This is the case with the compiler startup module crtO, because it is assembly code 
and contains no debug information. 

Backtrace Information. Whenever a break occurs in program execution, the 
backtrace window is updated. When updating the window, the debugger generates 
backtrace information as described in the following paragraphs. The backtrace 
window is displayed only in the high-level screen. 

Nesting level 0. Nesting level 0 information is based solely on the current 

value of the processor's program counter (PC). The module 
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and function shown at this level are selected because the 
value of the PC falls within their code spaces. 

Nesting level 1 . When program execution breaks on an address that has an 

associated public label (for example, a function entry 
point), nesting level 1 information is based on the 
processor SP. The debugger assumes that the SP is pointing 
to the return address because the label is assumed to be a 
function entry point and no stack frame has yet been 
established. With no stack frame available, the return 
address of the calling function is at the top of the stack. 
This return address is the address at level 1 . The module 
and function shown are based on this address, that is, the 
address falls within their code spaces. 

When program execution breaks on an address that has no 
associated public label, nesting level 1 is based on the 
processor' s frame pointer (register A6). In this case, the 
stack location four bytes above the location pointed to by 
register A6 contains the return address of the calling 
function. This address is the address shown at level 1 ; the 
module and function shown are based on this address. 

Nesting levels 2 through n are always based on existing 
stack frames. A stack frame is generated for each frame on 
the stack, based on saved frame pointers. Nesting levels 
are generated until backtracing of the stack encounters a 
zero frame pointer. This occurs when the stack frame 
associated with the compiler startup routines is 
encountered. 

If a function has no stack frame (due to compiling with the 
-O option), the function that called it does not appear in the 
backtrace window at any stack level other than levels 0 or 
1. 

Assembly language Assembly language functions that set up stack frames 
functions. appear in the backtrace window, but the information shown 

is incomplete. Since high level debug information is not 
present in such handwritten functions, the stack frame 
appears as a questionable frame. Additionally, there is no 



Nesting levels 2 
through n. 



Functions with no 
stack frame. 
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function name associated with the frame, i.e., it is 
displayed as <unknown>. 



To display all local variables of a function at the 
specified stack (backtrace) level 

• Select Disp Vars at Stack Level from the Backtrace window pop-up menu. 
Or: 

• Using the command line, enter: 

Program Context Expand <@stack._level> 

Enter the stack level preceded by an at sign (@), and press the <Retum> key. 

The values of the parameters passed to the function and the function's local 
variables are displayed in the Journal window. 

Example To display local variables at stack level 1, position the cursor over "1." in the 

Backttace window, and hold the right mouse button. Move the mouse to Disp 
Vars at Stack Level and release the button. 

Or, use the command Une to enter: 
Program Context Expand @1 
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To display the address of the C++ object invoking 
a member function 

• Display the value of the function's this pointer. 

If the program has stopped at a function, you can find out the address of the object 
which invoked the function. 

The program counter must be inside the function; otherwise you may see a "Local 
variable not ahve" error message. 



Example To see the address of the object that invoked the cfunc function in class C, enter the 

following string in the entry buffer: 

C : : cf unc\this 

then select DispIay^Var/Expression (). 
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Using Expressions 

This section shows you how to: 

• Calculate the value of a C expression. 

• Display the value of an expression or variable. 

• Monitor variables. 

• Discontinue monitoring specified variables. 

• Discontinue monitoring all variables. 

• Print formatted output to a window. 

• Print formatted output to journal windows. 



To calculate the value of a C expression 

• Enter the expression in the entry buffer, then select Display^C Expression (). 
Or: 

• Using the command line, enter: 
Expression C_Expression 

Enter the C expression to be calculated, and press the <Retum> key. 

The value of the C expression is displayed in the journal window. 

If the C expression is an assigimient statement, the Expression C_Expression 
command sets the value of the C variable. 

Examples To calculate the value of ' old_data' : 
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Expression C_Expression olci_ciata 

Result is: data address 000091DC {old_data} 

To calculate the value of member 'temp' of the first element of the old_data array 

of structures: 

Expression C_Expression old_data [ 0 ] . temp 
Result is: 

To assign the value 1 to 'num_checks' : 

Expression C_Expression num_checks = 1 
Result is: 1 0x01 



To display the value of an expression or variable 

• Use the mouse to copy the expression or variable into the entry buffer, then select 
Display^Var/Expression (). 

Or: 

• Using the command line, enter: 

Expression Display_Value 

Enter the expression or variable whose value is to be displayed, and press the 
<Retum> key. 

The value of the expression or variable is displayed in the journal window. 

The contents of an item, such as an array, are displayed instead of the C value of 
the item which is its address. 



Examples To display the value of the variable 'num_checks': 

Expression Display_Value num_checks 
Olh 

To display the address of the variable 'num_checks': 
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Expression Display_Value &num_checks 
000091F0 

To display the name of the current program module: 
Expression Display_Value @module 

To display the name of the current program function: 

Expression Display_Value @function 



To display members of a structure 

1 Copy the name of the structure into the entry buffer. 

2 Add an asterisk (*) in front of the name of the structure. 

3 Select Displays Var/Expression (). 

If you are using the command line, use the Expression Display_Value command. 



Example To display the names of the members of structure astruct, use the following 

expression in the entry buffer; 

*astruct 

The * operator tells the debugger to display the members of the structure, rather 
than the address of the structure. 



147 



Chapter 4: Viewing Code and Data 

To display the members of a C++ class 



To display the members of a C++ class 

• Using the command line, enter 

Symbol Display Options Search_all End_Options 

<class_name>\ 

This will display the type, size, protection, and overloading of each member of 

class_name. 



Example To display the members of class C, enter: 

Symbol Display Options Search_all End_Options C\ 



To display the values of all members of a C++ 
object 

• Enter the name of the C++ object in the entry buffer and select 
Display^Var/Expression (). 

Or: 

• Using the command line, enter: 
Expression Display_Value <object> 

Remember, you are displaying the values in an object, so you need to run the 
program to the point where the object is created. To display the members of a class, 
see "To display the members of a C++ class." 



Example To display the members of object cobj in class C, enter "cobj" in the entry buffer 

and select Display^Var/Expression (). 
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To monitor variables 

• Enter the variable to be monitored in the entry buffer and click on the Monitor () 
action key. 

Or: 

• Enter the variable to be monitored in the entry buffer and select Display ^Monitor 
(). 

Or: 

• Using the command line, enter: 

Expression Monitor Value 

Enter the variable to be monitored, and press the <Retum> key. 

The monitor window displays monitored variable expressions. This window can 
be displayed in both the high-level and assembly-level screens. 

Variables in the monitor window are updated each time the debugger stops 
executing the program. (The program is not considered to be "stopped" when a 
breakpoint with an attached macro is encountered.) 

Example To monitor the value of variable ' current_temp' : 

Expression Monitor Value current_temp 
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To monitor the value of a register 

• Monitor a register just as you would a variable. 

Example To monitor the value of register D2, enter " @D2" in the entry buffer and select 

Display^Monitor (). 

Or, using the command line, enter 

Expression Monitor Value @D2 . 



To discontinue monitoring specified variables 

• Select Delete Variable in the Monitor window pop-up menu. 
Or: 

• Using the command line, enter: 
Expression Monitor Delete 

Enter the number of the variable (shown in the monitor window) that should no 
longer be monitored, and press the <Return> key. 

The variable is removed from the monitor window. 

Example To stop monitoring variable 2 in the monitor window: 

Expression Monitor Delete 2 
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To discontinue monitoring all variables 

• Select Delete All Variables in the Monitor window pop-up menu. 
Or: 

• Using the command line, enter: 

Expression Monitor Clear_All 

All variables are removed from the monitor window. 



To display C++ inheritance relationships 

• Enter the name of a C++ class in the entry buffer, then select 
Display^Symbols^Browse C++ Class (). 

Or: 

• Using the command line, enter: 
Symbol Browse 

Enter the name of the C++ class to be displayed, and press the <Retum> key. 



To print formatted output to a window 

• Using the command line, enter: 
Expression Fprintf 
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Enter the number of the user-defined window, the format string (enclosed in 
quotes), and the arguments; then, press the <Retum> key. 

The formatted output is written to the user-defined window. This command is 
similar to the C fprintf function. 

The debugger associates the log file window (window no. 28) with a log (.com) file 
so that you can write output to that window using the Expression Fprintf command. 
This window is not displayed. It is used only for writing to a command file. 

The debugger associates the joumal file window (window no. 29) with a joumal 
file so that it can write journal window output to the journal (jou) file. Additional 
output may be written to the journal file by writing to window 29. 



Examples To print the value of var to user window 57 as a single character: 

Expression Fprintf 57,"%c",var 

To print a string in double quotes to user window 57 followed by the floating point 
value of 'float_temp' with a precision of 2: 

Expression Fprintf 57, "The value of ' f loat_temp' is: 
%.2f \n", float_temp 



To print formatted output to journal windows 

• Using the command line, enter: 

Expression Printf 

Enter the format string (enclosed in quotes) and the arguments; then, press the 
<Return> key. 

The formatted output is written to the joumal window. This command is similar to 
the C printf function. 



Examples To print the value of var to the joumal window as a single character: 

Expression Printf "%c",var 
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To print the string in double quotes to the journal window followed by the floating 
point value of 'float_temp' with a precision of 2: 

Expression Printf "The value of ' f loat_temp' is: %.2f 
\n", float_temp 

See Also "To view commands in a separate window" on page 132. 
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Viewing Memory Contents 

This sections explains how to to view, compare, and search blocks of memory. 



To compare two biocks of memory 

• Using the command line, enter: 

Memory Block_Operation Match <Mismatch_Operation> 

Select either Repeat_On_Mismatch or Stop_On_Mismatch to specify what happens 
when a mismatch is found, enter the address range to be compared and the starting 
address of the range that it is compared to; then, press the <Return> key. 



Example To compare the block of memory starting at address lOOOh and ending at address 

lOffh with a block of the same size beginning at address 5000h and stop when a 
difference is found: 

Memory Block:_Operation Match Stop_On_Mismatch 
lOOOh. . lOffh, 5000h 



To search a memory block for a value 

• Using the command line, enter: 

Memory Block_Operation Search <Size> <Until> 

Select either Byte, Word, or Long as the size of the memory locations, select either 
Once or Repeatedly to specify when the search should stop, enter the address range 
and the value that is to be searched for, and press the <Retum> key. 
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Example To search for the expression 'gh' in the memory range from address lOOOh through 

address lOffh and stop when the expression is found or address lOffh is reached: 

Memory Block:_Operation Search Word Once 
lOOOh. .+Oxff = 'gh' 



To examine a memory area for invalid values 

• Using the command line, enter: 

Memory Block_Operation Test <Size> <Until> 

Select either Byte, Word, or Long as the size of the memory locations, select either 
Once or Repeatedly to specify when the search should stop, enter the address range 
and the value that should be found in the range, and press the <Return> key. 



Example To test for the expression 'gh' in the memory range from address lOOOh through 

address lOffh and stop when a word not matching the expression is found: 

Memory Block;_Operation Test Word Once 1000h..+0xff = 
'gh' 



To display memory contents 

• Place a memory start location in the entry buffer and then select 
Display^Memory^<Form«?>. 

Or: 

• Using the command line, enter: 

Memory Display <Format> 
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Select either Mnemonic (()), Byte (()), Word (()), or Long (()) as the format in 
which memory contents are to be displayed. 

If you are using the command line, enter the starting address or the address range of 
the memory whose contents are to be displayed, and press the <Return> key. 



Examples To display disassembled memory in the code window starting at the symbol 

'_emeg_shutdown' (this command works only in assembly-level mode): 

Memory Display Mnemonic _emeg_shutdown 

To display memory in byte format in the journal window starting at the symbol 
'current_humid': 

Memory Display Byte current_humid 
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Using Simulated I/O 

Simulated I/O (SIMIO) lets programs use the UNIX file system, run UNIX 
commands, and use the keyboard and display for input and output. 

Your programs can use SIMIO by means of the I/O Ubraries and enviroimient 
dependent routines provided with the HP B3640 C Cross Compiler. Your 
programs use the library functions when they open, close, read, or write to files, 
etc. These simulated I/O functions are identical in both the debugger/emulator and 
debugger/simulator to let you write programs that will function correctly in both 
environments. Refer to the "Environment Dependent Routines" chapter of your 
compiler manual for information on using the C SIMIO libraries. 

If you are using the Microtec Research, Inc., C compiler (HP B3640), your 
programs can use SIMIO by means of the C routines supplied to you with the 
debugger/emulator software. These routines can be found in a subdirectory of 
debugger/emulator demo directory /usr/hp64000/demo/debug_env/<emM/ator> 
named "mri." Your programs can use these functions to open, close, read, or write 
to files, etc, in the debugger/emulator environment. See the "simio.c," "simio.h," 
and the "README" files in the "mri" subdirectory for more information. 

Your programs can also use simulated I/O by means of user-written assembly code. 
If you are developing programs that use simulated I/O from assembly code, refer to 
the Simulated I/O User's Guide for a complete description of simulated I/O 
protocol. 

This chapter shows you how to: 

• Enable simulated I/O. 

• Disable simulated I/O. 

• Set the keyboard I/O mode . 

• Redirect I/O. 

• Check resource usage. 

• Increase file resources. 

• Display the simulated I/O system report. 
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How Simulated I/O Works 

Communication between your program running in the emulation system and the 
SIMIO process takes place through contiguous single-byte length memory 
locations. The first memory location is called the Control Address (CA). The 
Control Address and the memory locations that follow it are called the CA buffer. 

Control Address buffers are less than or equal to 260 bytes in size. A maximum of 
256 bytes of information can be transferred between the debugger and the host 
system at one time. Some simulated I/O commands require four additional bytes 

for command parameters. 

Communication between a program and the simulated I/O process is a series of 
requests by the program and responses by the SIMIO process: 

The program places a SIMIO command in the CA buffer and then waits for a 
return code to be placed in the first byte of the CA. 

The SIMIO process polls the CA buffer memory. When it finds a command, 
the SIMIO process executes the command. When the SIMIO process 
completes the command, the first byte of the CA buffer is changed to the 
command retum code. 

Simulated I/O Connections 

The SIMIO system supports three types of I/O coimections. These are: 

• Keyboard and display. 

• UNIX files. 

• UNIX processes. 

Display and Keyboard 

The debugger provides a window named stdio which functions as the normal 
display output for target programs. The screen can be opened for output from 
target programs via SIMIO with the special name /dev/simio/display. This name 
appears to be an UNIX file name. However, it is really a name reserved by the 
debugger to indicate the internal screen. The keyboard is accessed by the special 
name /dev/simio/keyboard. 

UNIX Files 

UNIX files are accessed by their names from the target program miming in the 
debugger in the same way they are accessed by host software. The file operations 
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of open, close, read, write, and seek are supported by the SBVnO protocol. When 
opening a stream on an UNIX file, SIMIO supports the same control parameters for 
file creation and blocking I/O that are available to host programs. 

UNIX Processes 

UNIX processes can be run as subprocesses to the debugger with their input and 
output directed to the user program. Subprocesses are controlled from the user 
program by a Process Identification number (PID). This lets the user program 
check specific subprocesses, send them signals, or stop them. This subprocess 
facility allows user programs to take advantage of the powerful software and 
execution environment of the host UNIX system. Host programs can be used to 
process data for a debugger user program or to simulate portions of the software 
that are not available in the user program. 

Because simulated 1/0 lets the debugger execute UNIX commands, the debugger 
can communicate with other host system I/O devices, such as printers, plotters, 
modems, etc. 

For more information on using UNIX processes, refer to the description of the 
exec_cmd() function in the "Environment Dependent Routines" chapter of the 
68000 Family C Cross Compiler User's Guide. 

Special Simulated I/O Symbols 
User Program Symbols 

The following symbols are user program symbols that are used by the SIMIO 
system to process the simulated I/O protocol: 

systemlo_buf This symbol indicates the start of the Control Address buffer. 
Simulated I/O Reserved Symbols 

The following names are reserved by the SIMIO system and cannot be used for 
your file names. The SIMIO system recognizes these names and uses special 
processing to direct the I/O to the proper location: 

Stdin This name will be replaced by the name stored in the stdin_name. This 
name is set via the Stdio_Redirect command. 
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Stdout This name will be replaced by the name stored in the stdout_name. This 
name is set via the Stdio_Redirect command. 

Stderr This name will be replaced by the name stored in the stderr_name. This 
name is set via the Stdio_Redirect command. 

/dev/simio/keyboard This name refers to the keyboard while the product is 
running interactively. 

/dev/simio/display This name refers to the stdio display window while the 
product is running interactively. 



To enable simulated I/O 

• Using the command line, enter: 

Debugger Execution IO_System Enable 

When SIMIO is enabled, polling for simio command begins. In the 
debugger/emulator, the host computer periodically reads the memory in the 
emulator or target system to detect simio commands issued by the user code. 
SlMlO behavior in the debugger is identical to that described in the Simulated I/O 

User's Guide. 

SIMIO is also enabled if the "Enable polling for simulated I/O?" emulator 
configuration question was answered yes. 



To disable simulated I/O 

• Using the command line, enter: 

Debugger Execution IO_System Disable 
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To set the keyboard I/O mode to cooked 

• Using the command line, enter: 

Debugger Execution IO_SYstem Mode Cooked 

In the Cooked mode, the keyboard input is processed. This lets you type and then 
edit the line to correct errors. When the final line is composed, press the <Return> 
key to enter the line. Once the line is entered, it is read by the target program. 
Only the characters from the final line and the carriage return character are passed 
as input. If program execution is interrupted by entering <Ctrl>-C before the Une 
is entered, the characters on the input line are lost. 

See also "To set the keyboard I/O mode to raw" 



To set the keyboard I/O mode to raw 

• Using the command line, enter: 

Debugger Execution IO_System Mode Raw 

In the Raw mode, each character you type is sent directly to the target program that 
is reading from the keyboard. Characters are not echoed as they are typed. Any 
input editing, such as backspace, must be handled by the target program. The only 
special character that cannot be sent to the target program is <Ctrl>-C which is 
used to interrupt the debugger's execution of the program. 

See also "To set the keyboard I/O mode to cooked" 
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To control blocking of reads 

• Set the 0_NDELAY flag in the startupQ routine. 

The flag OJVDELAY is passed to the function open() to control whether or not 
reads from the keyboard will block waiting for characters. This flag can only be 
set when opening the stream; it may not be changed after the file stream is open. 
This flag can be set in the compiler- supplied routine startup(). This routine opens 
streams stdin, stdout, and stderr. 

See also The chapter titled "Environment Dependent Routines" in the 68000 Family C 

Cross Compiler User's Guide manual. 



To redirect I/O 

To redirect the three I/O streams and to reset your program to the startup address, 
perform the following steps. 

1 Redirect the three I/O streams by changing the translation names for the stdio 
streams. Using the command line, enter: 

Debugger Execution IO_SYstem Stdio_Redirect 
<"stdin_name", "stdout_naine" , "stderr_name"> 

Enter the new names for standard input, standard output, and standard error; then, 
press the <Retum> key. 

2 Reset the program counter to the startup address. Select Execution^Set PC to 
Transfer. Or, using the command Une, enter: 

Program Pc_Reset 

When the target program starts execution from the normal compiler startup 
address, the standard C startup libraries open the following three I/O streams: 

• stdin 
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• stdout 

• stderr 

The debugger uses an internal table to determine where the streams should be 
opened. Each of the names (stdin, stdout, and stderr) has an associated translation 
name: 

• stdin_name 

• stdout_name 

• stderr_name 

The translation name contains the name of a file to use when the target requests 
opening of any of these stdio streams. By default, stdin_name contains 
/dev/simio/keyhoard (the keyboard), and translations stdout_name and stderr_name 
conlsm /dev/simio/display (the standard I/O (stdio) screen). 

These translations are used only when opening the streams. They cannot be used to 
redirect the streams after they have been opened. The target program must be rerun 
from the startup address to allow the stdio streams to be reopened if the translations 
have been changed. 



Examples To redirect the standard input file to the keyboard, the standard output file to the 

display, and the standard error file to file Vusers/project/errorfile': 

Debugger Execution IO_System Stdio_Redirect 
" / dev/ simio/ keyboard" , " /dev/ simio/ display" , 
"/users /pro ject/errorfile" 

Program Pc_Reset 

To redirect the standard input file to 'temp.dat', the standard output file to 
'cmdout.dat', and the standard error file to file 'errorlog.err': 

Debugger Execution IO_System Stdio_Redirect 
"temp . dat " , "cmdout . dat " , "error log .err" 

Program Pc_Reset 
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To check resource usage 

• Using the command line, enter: 

Debugger Execution IO_SYstem Report 

The command displays the simulated I/O status, keyboard mode, and the 
translation names used for stdin, stdout, and stderr. 

The SIMIO system has the following default resource limitations: 

• 40 open files 

• 4 subprocesses 



To increase I/O file resources 

1 Change to directory 68332 in pa.th/usr/hp64000/include using the cd command. 

2 Change the value of macro FOPEN_MAX from 12 to the new maximum number of 
open files (the limit is 40) in file stdio.h using an editor on your system. 

3 Change to the appropriate environment directory undsi /usr/hp64000/env/, then 
change to the src subdirectory. 

4 Recompile file startup.c. Type: 
CC68332 -Ouc startup.c 

5 Add startup.o to the environment hbrary using the command: 
ar68k -r startup ../env.a 

You can increase the simulated I/O file Umit by modifying the startup code for 
your compiler. The code must be modified from the UNIX shell. The maximum 
number of open SIMIO files descriptors can be increased to 40. 
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Caution Compiler startup files compiled with the moditied stdio.h header file will run only 

in the debugger envirormient. Emulators which do not have the debugger interface 
do not support the inaeased number of open SIMIO file descriptors. Calls to the 
SIMIO function open() will fail in this environment if 12 file descriptors have 

already been allocated. 
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5 



Making Trace Measurements 

How to use the debugger to trace tlie execution of a program in tlie emulator. 
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NOTE You cannot use the debugger interface to make trace measurements with the 

HP Softwre Probe. 



This chapter shows you how to: 

• Start traces. 

• Stop traces. 

• Display traces. 

• Specify trace events. 

• Delete trace events. 

• Specify storage qualifiers. 

• Specify trigger conditions. 

• Halt program execution on the occurrence of a trigger. 

• Remove a storage quaUfication term. 

• Remove a trigger term. 

The Trace Function 

The trace function uses the emulation analyzer in your emulator to capture 
processor bus cycle information synchronously with the processor's clock signal. 
A trace is a collection of these captured states. 

The trace function is not available if you are using an HP Software Probe. If you 
need to trace bus activity, use an HP emulator or logic analyzer. 

You can make simple trace measurements using the Code window pop-up menu. 
Using this menu, you can trace states before and after a line of code is executed. 

If you need to make a simple trace measurement, skip the details which follow and 
turn to "To start a trace using the Code pop-up menu." 

You can make complex trace measurements using the command line Trace 
command. You can tell the debugger exacdy which states to store by defining 
trigger events (a series of events which will start the trace) and storage 
qualifications (which kinds of states to store). 

If you will be making many detailed trace measurements, you may find it easier to 
use the emulator/analyzer user interface. 



168 



Chapter 5: Making Trace Measurements 



Default Trace Specification 

The default trigger condition is "never". You can make a default trace 
measurement by entering the Trace Again command. When you use the default 
trace condition, qualified bus cycles are collected continuously until you halt the 
measurement. The trace buffer will then contain the bus states prior to the halt. 

Trace Events 

Trace measurement parameters are specified as events. An event is a bus state 
consisting of a combination of address, data, and status values. 

Address and Data Values. Address and data values may be specified as 32-bit 
values or a range of of 32-bit values. You can specify a mask to mark valid bits in 
addresses or data to define "don't care" values. You can also specify the logical 
"NOT" of an address or data value. 

Status Values. Status values are the types of bus aaivities, such as: 
Read or write operations. 

Memory access size. 

Function codes. 

Cycle types. 

You can also specify the logical "NOT" of a status value. 
Trace Trigger 

A trigger specifies the bus events that cause the debugger to make a trace 
measurement. The debugger lets you trigger on the detection of a single event, an 
OR'ed combination of events, or after a sequence of events are detected. You can 
specify a sequence of events, the last of which is the triggering event. You can also 
trigger on the Nth occurrence of an event, where N is a number you specity with 
the CO u/it parameter in the Trace Trigger Ever; t command. 

You can position the trigger event at the start of the trace buffer, centered in the 
trace buffer, or at the end of the trace buffer. 
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Storage Qualification 

A storage qualifier defines which bus cycles will be stored when you make a trace 
measurement. You can specify that only cycles corresponding to certain values be 
stored in the trace buffer. These values can be addresses, a range of addresses, data 
values, status values (the type of bus activity), or an OR'ed combination of values. 
You can also specify the logical NOT of the specified value to be the storage 
qualifier, that is, any condition that does not match the specification. You can 
specify that the trace function store up to two instruction fetch cycles preceding the 
qualified state (prestore). 

Trace Resources 

The trace function uses the emulation analyzer to implement its measurements. 
The analyzer puts the following Umitations on resources available for trace 
specifications: 

• One range resource. 

• Eight event resources. 

• Seven sequence terms. 

If you enter a range value that can be expressed as a "don't care" value (for 
example, address 0x100 to OxI f/), the debugger uses one of the eight 
event resources, rather than the range resource. Complex event specifications, such 
as combinations of Is and Not terms, can use multiple event resources. Up to 
seven sequential events can be specified in a trigger specification. 

Trace Status 

The status of the trace measurement is indicated on the debugger status line by the 
TRC: <Trc_status> field. The possible values for <Trc_status> are: 

AwtTrg A trace measurement is in progress, but the trigger condition 



has not been detected. 



BrkRWA 



An access breakpoint has been set and will be used as the 
trigger in the next trace measurement. 



Cmplt 



A trace measurement has completed. 



DataOK 



The trace buffer contains valid data. 
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Halted The Tra ce Halt command was used to halt the trace. 

Idle No trace measurement has been executed during the current 

debug session. 

Setup A trace measurement has been set up (specified), and will start 

on the next program run or program step command. This status 
message appears only before the first trace measurement in a 
debug session. 

Trgrd A trace measurement is in progress, and the trigger has been 

detected. 

Trace status characters 

When trace data is displayed, a trace status character may be displayed in front of 
the trace line. The following table defines the trace status characters. 



Trace List Status Characters 



Character Description 

* The indicated trace line is the trigger condition. 

+ The indicated trace line is in the middle of a C statement, that 

is, not the first assembly language statement in the C source 
statement. 

! The data in the trace buffer line does not match the data in 

memory. 

? The trace Une may be a prefetch. 



Access Breakpoints 

If you have set access breakpoints with the Breakpt Access, Breakpt Read, or 
Breakpt Write commands, the trace function will interpret the breakpoints as trace 
trigger terms. When you step or run your program after setting an access 
breakpoint, the trace measurement is started automatically. You cannot define a 
trace trigger while an access breakpoint is active. This will cause an error 
condition. 
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Note The emulator user interface may specify a trace that overrides a debugger access 

breakpoint. The debugger interface will set up the access breakpoint trace when a 
run or step command is issued only if the analyzer is not currently in use. Using 
both access breakpoints in the debugger and trace features in the emulator is not 
recommended. 



Limitations to the Trace Function 

There are limitations to the trace function imposed on the debugger when 
triggering on C variables and instruction fetches. 

Limitations wlien Using a Foreground Monitor. When you use a 
foreground monitor, the trace function may capture monitor activity as well as your 
target program activity. 

Limitations wlien Triggering on C Variables. The emulator's analysis 
hardware watches bus cycles, and triggers on specified bus values. However, bus 
cycles do not always map directly to C variables. This limitation takes two forms. 

The first form occurs when an access to a C variable requires multiple bus cycles. 
To illustrate this problem, consider a 32-bit variable foo. A C statement that sets 
the value of foo requires two bus cycles for a 16-bit data bus. If foo is at address 
0x1000, the statement: 

foo = 0x100 

win result in a write of value 0 to address 0x1000 and value 0x100 to address 
0x1002. To trigger on a write of 0x100 to foo requires that you trigger on a write 
of value 0 to address 0x1000 and then value 0x100 to address 0x1002. You must 
be aware of your data bus configuration and date organization when specifying 
triggers containing both address and data values. 

The second form of problem occurs when a C variable is written, but the address 
never appears on the bus. To demonstrate this problem, consider a 32-bit C 
variable foo at address 0x1 002 and a "wild pointer" pointing to address 
0x1004. A write indirect through the pointer will overwrite part of variable foo, 
but the address of foo ( 0x1 0 02) will never appear on the address bus. This 
limitation can be overcome by specifying an address range when triggering on a 
symbol that you suspect is being modified by a wild pointer. For example, specify 
the range of foo as foo . . +3. 
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To start a trace using the Code pop-up menu 

1 Position the mouse pointer over tlie line of code which should trigger the trace. 

2 Hold down the right mouse button and select one of the Trace items from the Code 
window pop-up menu. 

3 When "TRC:Cmplt" appears on the status line, stop execution of the program if it 
is not already halted. 

4 Select Window^Trace to see the trace information. 

5 Use the keyboard arrow keys or the scroll bar to scroU through the trace 
information. Press <ESC> <ESC> to exit trace mode. 

This wUl trace the execution of code near the Une you selected. 
You can choose any one of the following: 

• Trace after will trace what happens after the selected line is executed. 

• Trace before will trace what happens before the selected hne is executed. 

• Trace about wUl trace what happens before and after the selected Une is 
executed. 

• Trace until wiU trace what happens before the selected Une is executed. 
When the selected line is reached, execution is stopped automatically. 



To start a trace using the command line 

A trace measurement is started on the first Program Step or Program Run 
command following the specification of a trigger or storage quaUfier, or after a 
Trace Again command. 
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The Trace Again command starts the trace using the last trace specification you 
set up or the default trace specification if you have not set up a trace in the current 
debug session. The default specification is: 

Trace StoreQual None 

Trace Trigger Never 

The default specification causes the trace to execute continuously, storing all bus 
states in the trace buffer, until you stop the trace by entering the command: 

Trace Halt 

If you have set up a trace specification, the trace function behavior is determined 
by your specification. 

The debugger must be in command mode (your target program is halted and the 
word Command is displayed on the status Une) in order for you to enter a trace 
command. 



To stop a trace in progress 

• Using the command line, enter: 
Trace Halt 

And press the <Return> key. 

If the trace trigger specification is defined to be Tra ce Trl gger Never, the 
trace function will run continuously until you halt the trace. 

If you have defined a trace trigger specification, the trace function stops 
automatically when the trace trigger specification is detected and the trace buffer is 
fuU. 
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To display a trace 

• Select Window^Trace. 

Or: 

• In the emulator/analyzer window, select Display^Trace. 
Or: 

• Using the command line, enter: 

Trace Display 

And press the <Return> key. 

The default trace display shows the high-level program source hues corresponding 
to the trace states and entries and exits from modules. 

Display options allow you to display entry to and exit from modules, assembly 
language instructions, data read and write cycles, and the raw uninterpreted data 
collected by the trace function. 

The Line (s) option allows you to specify a range of lines in the trace buffer to 
be copied to a specified debugger window or the first state to be displayed in the 
trace window. 

Examples To view source Unes, their corresponding assembly language instructions, and data 

read and write cycles: 

Trace Display Modules Source Assembly Data 

To copy the raw data in Unes -20 through +20 of the trace buffer to a log file you 
have opened: 

Trace Display Lines -20.. 20 <Tab> Raw OutputTo 28 
28 is the window number for the log fUe. 
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To display the raw data starting with the trigger state in the trace window and cause 
the debugger to enter trace mode: 

Trace Display Lines 0 <Tab> Raw 

To exit trace mode, press the <Esc> key twice. This action returns the debugger to 
command mode where you can enter commands from the keyboard. 



To specify trace events 

• Using the command line, enter: 

Trace Event Specify <event_nmbr> <Tab> 
<event_def inition> 

And press the <Retum> key. 

You use trace events as terms in the trace trigger specification and in the storage 
qualification specification. The event definition can be address values, data values, 
status values, or a logically AND'ed combination of the above. 



Examples Address event. To define event 1 to be the address of function update_system: 

Trace Event Specify 1 <Tab> Address Is update_system 

Status event. To define event 2 to be any bus cycle corresponding to an 
instruction fetch from supervisor memory space: 

Trace Event Specify 2 <Tab> Status Is FnCde Supr CycTyp 
Fetch 

Combined address and status event. To define event 3 to be a write access of 
variable current_humid offset by 2: 

Trace Event Specify 3 <Tab> Address Is 

& (H B) current_humid+2 <Tab> Status Is Write 

The H B (hex byte) type cast allows you to specify an offset of two so that the 
debugger can capture the two least significant bytes of current_humid, a 32-bit 
integer value. 
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To delete trace events 

• Using the command line, enter: 

Trace Event Delete <event_nmbr> 

Enter the number of the event you wish to delete, and press the <Retum> key. 

If you attempt to delete an event that is assigned to a storage qualification term or 
trigger term, the debugger will display an error message on your screen. You 
cannot delete events that are assigned as storage qualifiers or trigger terms. You 
can, however, modify these events by entering a new specification. 

Examples To delete event 2: 

Trace Event Delete 2 



To specify storage qualifiers 

• Using the command line, enter: 

Trace StoreQual Event <event_nmbr> 

Enter the number of the event previously defined with the Trace Event Specify 
command, and press the <Return> key. 

You can specify a single event or an OR'ed combination of events in the trace 
storage qualification specification. 

If you specify the Prestore function, the trace function stores the two instruction 
fetch bus cycles immediately preceding the qualified states being stored. 

Examples To store either of two events: 

Trace Event Specify 1 <Tab> Address Is update_system 
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Trace Event Specify 3 <Tab> Address Is 

& (H B) current_humid+2 <Tab> Status Is Write 

Trace StoreQual Event 1 <Tab> Or 3 

The debugger will then store calls to function update_system or write accesses to 
variable currentjiumid. 

To store accesses to update_system along with the two bus cycles immediately 
preceding the accesses: 

Trace StoreQual Address Is update_SYstem <Tab> Prestore 

The prestore operation helps you determine what instructions caused an access to a 
variable or function. 

Note that in the preceding example, we defined the quahfying event in the Trace 
StoreQual command rather than using an event defined previously with the Trace 
Event Specify command. When you define the qualifying event in the Trace 
StoreQual command, you can specify only a single event. You cannot use an 
OR'ed combination of events as the storage quahfication condition. 



To specify trigger conditions 

• Using the command line, enter: 

Trace Trigger Event <event_nmbr> 

Enter the number of the event previously defined with the Trace Event Specify 
command, and press the <Return> key. 

You can specify a single event, an OR'ed combination of events, a specified 
number of occurrences of a single event or an OR'ed combination of events, or a 
sequence of events (maximum of seven) in the trace trigger specification. If you 
specify a sequence of more than seven events, the debugger will respond with an 
error message indicating that the specification is too complex. 

You can define the trigger event in the Trace Trigger command rather than using 
an event defined previously with the Trace Event Specify command. When you 
define the qualifying event in the Trace Trigger command, you can specify only a 
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single event. You cannot use an OR'ed combination of events, a sequence of 
events, or multiple occurrences of an event as the trigger condition. 



Examples Trigger on a single event. To trigger on the occurrence of a call to function 

update_system: 

Trace Event Specify 1 <Tab> Address Is update_system 
Trace Trigger Event 1 

Trigger on a sequence of events. To trigger on a call to function 

update_system followed by a write access to variable current_humid: 

Trace Event Specify 1 <Tab> Address Is update_system 

Trace Event Specify 3 <Tab> Address Is 

& (H B) current_humid+2 <Tab> Status Is Write 

Trace Trigger Event 1 <Tab> Then 3 

Trigger on an OR'ed combination of events. To trigger on a call to function 

update_system or a write access to variable current_humid: 

Trace Event Specify 1 <Tab> Address Is update_system 

Trace Event Specify 3 <Tab> Address Is 

& (H B) current_humid+2 <Tab> Status Is Write 

Trace Trigger Event 1 <Tab> Or 3 

Trigger on the nth occurrence of an event. To trigger on the fifth call to function 

upda t e_sys t em: 

Trace Trigger Event 1 <Tab> Count 5 
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To halt program execution on the occurrence of a 
trigger 

• Enter the keyword BrkOn Trg in your trace trigger specification to halt program 
execution on occurrence of the trigger condition. 



Examples To break on a write to memory location current_humid: 

Trace Trigger Event 3 <Tab> BrkOnTrg PosnTrig End 

When you start your program, the debugger will execute the program until the 
trigger condition is detected. Then the debugger will halt the program. The 
keywords Posn Tri g End cause the trigger to be stored at the end of the trace 
buffer, allowing you to view events leading up to the trigger. 



To remove a storage qualification term 

• Using the command line, enter: 

Trace StoreQual None 
And press the <Return> key. 

This command restores the storage qualification to its default value, that is, all bus 
cycles win be stored in the trace buffer. If you specified events defined with the 
Trace Event Specify command, the events are removed from the storage 
qualification specification, but remain defined. 
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To remove a trigger term 

• Using the command line, enter: 

Trace Trigger Never 
And press the <Retum> key. 

This command restores the trace trigger to its default value. Events in trigger terms 
defined with the Trace Event Specify command are disabled as trigger terms, but 
are not removed as events. The Trace Trigger Never command causes the trace 
function to never trigger. The trace will run continuously until you stop the trace 
using the Trace Halt command. 



To trace code execution before and after entry 
into a function 

1 Specify the trigger condition. 

Trace Trigger Address Is function_name <Tab> Status Is 
CycTyp Fetch PosnTrig Center 

2 Run the program. 

3 When the trace is completed (the command line will contain the message 

TRC : Cmpl t), press CTRL C to halt program execution and enter command mode. 

4 Display the trace data. 
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To trace data written to a variable 

1 Define trace event 1 to be a write access to the range of addresses corresponding to 
the variable. 

Trace Event Specify 1 <Tab> Address Is 

&variable .. +sizeof {variable) -1 <Tab> Status Is Write 

By using the slzeof operator, we can specify an address range the size of the 
variable to ensure that we capture all bytes of variable. 

2 Assign variable as the trigger and storage qualification terms. 

Trace Trigger Address Is Svariable 
Trace StoreQual Event 1 

3 Start program execution. 

4 Complete the trace. 

The the TRC status on the status line will change to TRC : Trgrd to indicate that 
the first write has taken place. 

You may do one of two things to complete the trace: 

• To see a full buffer of writes, wait until the status changes to TRC : Cmplt. 

• To see the trace without waiting, press <Ctrl>-C to return to command mode, 
then halt the trace by entering: 

Trace Halt 

5 Display the trace information. 
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To trace data written to a variable and wlio wrote 
to the variable 

1 Define trace event 1 to be a write access to the range of addresses corresponding to 
the variable. 

Trace Event Specify 1 <Tab> Address Is 

Sivariable .. +sizeof (variable) -1 <Tab> Status Is Write 

2 Assign the variable as the trigger and storage qualification terms. 

Trace Trigger Address Is ^variable 

Trace StoreQual Event 1 <Tab> Prestore 

Note that we added the Prestore keyword to the Trace StoreQual command. 
The Prestore keyword in the storage qualification definition will cause the trace 
function to capture the last two fetch cycles before the write to current_humid, 
enabling you to see which routine is writing to the variable. 

3 Start program execution. 

4 Complete the trace. 

The the TRC status on the status line will change to TRC : Trgrd to indicate that 
the first write has taken place. 

You may do one of two things to complete the trace: 

• To see a full buffer of writes, wait until the status changes to TRC : Cmplt. 

• To see the trace without waiting, press <Ctrl>-C to return to command mode, 
then halt the trace by entering: 

Trace Halt 

5 Halt the trace measurement. 

6 Display the trace information. 
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To trace events leading up to writing a particular 
value in a variable 

To trace events leading up to writing the value 0 (zero) to the element seconds in 
a structure pointed to by time, perform the following steps. 

1 Define event 1 to be the write of a data value of 0 to the integer value 
nuin_checks. 

Trace Event Specify 1 <Tab> Address Is 

& (H B) time_struct . seconds+2 <Tab> Data Is 0 <Tab> 

Status Is Write 

2 Assign event 1 to be the trace trigger, and position the trigger at the end of the trace 
buffer so that states leading up to the trigger will be captured. 

Trace Trigger Event 1 <Tab> PosnTrig End 

3 Disable any storage qualification terms to cause the trace function to store all states. 
Trace StoreQual None 

4 Start program execution and the trace. 
Program Run 

5 When the trace is completed (the command line will contain the message 

TRC : Cmpl t), press CTRL C to halt program execution and enter command mode. 



6 Display the trace information. 



184 



Chapter 5: Making Trace Measurements 
To execute a complex breakpoint using tlie trace function 



To execute a complex breakpoint using the trace 
function 

The trace function can be used to execute a complex breakpoint in your target 
program. 



Example 1 Define event 6 to be a write of value Ox3c (60 decimal) to the least- signiiicant 

word of the integer value seconds. 

Trace Event Specify 5 <Tab> Address Is 

& (H B) time->seconds+2 <Tab> Data Is 0x3c <Tab> Status 

Is Write 

2 Define event 7 to be a write to the least- significant word of the integer value 
minutes. 

Trace Event Specify 7 <Tab> Address Is 

& (H B) tiine->minutes+2 <Tab> Status Is Write 

3 Define the trace trigger as event 6 followed by event 7, and position the trigger at 
the center of the trace buffer so that states leading up to the trigger and following 
the trigger will be captured. 

Trace Trigger Event 6 <Tab> Then 7 <Tab> BrkOnTrg 
PosnTrig Center 

The keyword BrkOn Trg causes the debugger to halt program execution when the 
trigger condition is detected. 

4 Start the trace measurement. 
Program Run 

The program will run until the trigger condition is detected and then halt. 

5 Display the trace buffer. 

Trace Display Line(s) 0 <Tab> Source Assembly Data 
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Note that the minutes count is updated at line 0 in the trace display. The trigger 
specification has allowed us to see the program activity leading up this event. 
Press the Return key or F7 function key to scroll through the data source hue by 
source Une. Note that the highhghted line in the code window tracks the first line 
displayed in the trace display. Press the F6 function key to change the direction of 
tracking in the trace display. 



To trace entry to and exit from modules 

1 Define event 5 to be any instruction fetch with an opcode value of 4e5x where x 
is a don't care value. 

Trace Event Specify 5 <Tab> Data Is 0x4e50 &= OxfffO 
<Tab> Status Is CycTyp Fetch 

The don't care condition is specified by specifying a mask in the data specification. 
(S= is the mask operator. This value corresponds to the UNK and UNLK 
instructions. 

2 Define event 5 as the trace storage qualifier. 
Trace StoreQual Event 5 

3 Restore the trace trigger to its default value. 
Trace Trigger Never 

4 Start the program and trace. 
Program Run 

5 Let the program run for a moment, then press CTRL C to halt program execution 
and enter command mode. 

6 Stop the trace measurement. 
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Trace Halt 
7 Display the trace information. 

Trace Display Modules Assembly 

The display should show entries and exits of modules and the assembly code that 
was captured in the trace buffer. The code should consist of only LINK and UNLK 
instructions. 



Note This method of viewing entries and exits of modules may not work for all code. It 

will depend on how your compiler generates code and which compiler options you 
choose. 
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6 



Editing Code and Data 

How to use the debugger to make permanent or temporary changes to source code, 
memory contents, and registers. 
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Editing Files 

The graphical interface gives you a number of context-dependent and 
context-independent editing commands. From several screens, you can bring up 
the source file that contains the source line or symbol you are viewing in the 
display. 

The interface wiU choose the "vi" editor as its default editor, unless you specify 
another editor by setting an X resource. Refer to the chapter "Configuring the 
Debugger" for more information about setting this resource. 

Rememlser to re-compile 

When you use the editor to change a source code file, you will need to re-compile 
the source file. You can recompile with a cUck of the mouse if you define the 
Make action key to compile the target program. 



To edit source code from the Code window 

• Place the mouse pointer over the Une you want to edit. Select Edit source from the 
Code window pop-up menu. 

The debugger will start the editor in a new X window. The cursor in the editor 
window will be on the same line of code as the mouse pointer in the Code window. 

After editing the file, you quit the edit session by the standard method for the editor 
used. 

You will need to re-compile the source file. You can recompile with a click of the 
mouse if you define the Make action key to compile the target program. 
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To edit an arbitrary file 

1 Select File^Edit^FUe. 

2 Using the file selection dialog box, enter the name of the file you wish to edit; then, 
cUck on the OK pushbutton. 

After editing the file, you quit the edit session by the standard method for the editor 
used. 



To edit a file based on an address in the entry 
buffer 

1 Place an address reference (either absolute or symbolic) in the entry buffer. 

2 Select File^Edit^At () Location. 

The interface determines which source file contains the code generated for the 
address in the entry buffer and opens an edit session on the file. 



To edit a file based on the current program 
counter 

• Select File^Edit^At PC Location. 

The interface determines which source file generated the address currently in the 
program counter and opens an edit session on that source file. The interface will 
issue an error if it cannot find a source file for the address in the PC. 
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Patching Source Code 

When you change source code by editing the C source file, you need to re-compile. 
The debugger provides several ways to patch your program without re-compiling: 

• Change a variable' s value using a C expression. 

• Apply a patch using a breakpoint macro. 



To change a variable using a C expression 

1 Enter a C expression in the entry buffer. 

A good way to do this is to highlight an expression from your source code using the 
left mouse button. When you release the button, the expression will appear in the 
entry buffer. Now edit the expression to have the desired value. 

2 Chck on the C Expr () action key. Or select Display^C Expression from the 
menu bar. 

The value of the variable will be changed until the program modifies it. You can 
continuously monitor the variable's value if you display it in the Monitor window 
(use the Monitor () action key or the Expression Monitor Value command). 

Or: 



• Using the command line enter: 

Expression C_Expression <expression> 
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To patch a line of code using a macro 

1 Set a breakpoint at the line you wish to patch. 

An easy way to set the breakpoint is to click the right mouse button on the line in 
the Code window. 

2 Attach a macro to the breakpoint. 

Choose Attach Macro ... from the Code window pop-up menu. 

3 Write a macro to patch the code. 

In the Macro Operations dialog box, enter the name of a new macro and chck on 
the Edit button. 

The macro may contain any number of C expressions and debugger commands. 

The last two lines of the macro should be: 

$Modify Register @PC = #next_Jir!e$; 
return (1) 

where nextjine is the number of the Une after the breakpoint. Return 0 instead of 1 
if you want the debugger to stop after the macro is executed. 

Exit the editor as usual, then click on the Attach button in the Macro Operations 
dialog box. 

Now whenever the breakpoint line is encountered, the debugger will execute the 
macro before the patched line is executed. The macro wiU execute your patch 
code, then skip to the next line. 
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To patch C source code by inserting lines 

1 Define a macro containing the inserted statements. The macro must provide a 
return value of 1 (true) in order for the program to continue after the macro is 
executed. 



2 Set a breakpoint on the C Une following the point where the insertion should occur 
and attach the macro to the breakpoint. 

3 Start your program. 

The program will run until the breakpoint is encountered. The debugger will then 
interpret and execute the C statements in the macro, and continue executing the 
program. 



To patcli C source code by deleting lines 

1 Write a macro that sets the program counter to point to the first line of code beyond 
the lines of code that you want to delete. The macro must provide a return value of 
1 (true) in order for the program to continue after the macro is executed. 

2 Set a breakpoint on the first line to be deleted and specify the macro with that 
breakpoint. 

3 Start your program. 

The program will run until the breakpoint is encountered. The macro will then set 
the program counter to the line specified in the macro. Program execution will 
then continue, skipping the program lines between the breakpoint and line specified 
in the macro. 



Example Consider the following code: 

25 count = 5; 

26 for (i=0; i < MAXNDM; i++) 
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27 { 

28 array [i]=l; 

2 9 count=count+2 ; 

30 k=count*i; 

31 } 

To delete lines 29 and 30, and insert a new line incrementing count by one, you 
could write the following macro: 

Debugger Macro Add patch_29() 
{ 

count++; 

$Expression C_Expression @PC = #31$; 
return ( 1 ) ; 

} 



To execute the code patch, enter the command: 
Breakpt Instr #2 9;patch_29 () 

and run your program. 
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Editing Memory Contents 

This section shows you how to: 

• Change memory location values. 

• Copy a block of memory. 

• Fill a block of memory with values. 

• Compare two blocks of memory. 

• Change the contents of a register. 

• Unload BBA data from program memory. 



To change the value of one memory location 

1 Select Modify^Memory. 

Or, using the command line, enter: 
Memory Assign <Size> 

2 Using the command line, select either Byte, Word, or Long as the size of the 
memory location, and enter the expression that assigns a value to an address, and 
press the <Retum> key. 



To change the values of a block of memory 
interactively 

1 Select Modify ^Memory. 
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Or, using the command line, enter: 
Memory Assign <Size> 

2 Using the command line, select either Byte, Word, or Long as the size of the 
memory location, enter the address of the beginning of the block, and press the 
<Retum> key. 

This starts the interactive memory modification mode. 

3 Enter the value for the location displayed in the Journal window and press the 
<Return> key. 

4 To exit this mode, press the <Retum> key without entering a value. 



Example To display the contents of memory location lOOOh and allow interactive 

modification of memory contents: 

Memory Assign Byte lOOOh 
00001000 = 0x48 72: 



To copy a block of memory 

1 Using the command line, enter: 
Memory Block_Operation Copy 

2 Enter the address range of the memory to be copied, followed by a comma. 

3 Enter the starting address of the destination and press the <Retum> key. 



Example To copy the block of memory starting at address lOOOh and ending at address lOffh 

to a block of the same size starting at address 5000h: 

Memory Block_Operation Copy lOOOh . . lOf f h, 5000h 
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To fill a block of memory with values 

• Using the command line, enter: 

Memory Block_Operation Fill <Size> 

Select either Byte, Word, or Long as the size of the memory locations, enter the 
expression that assigns a value to locations in a range of addresses, and press the 
<Return> key. 

Example To fill memory locations lOOOh through 1007h with the long pattern 61626364, 

65666768: 

Memory Block_Operation Fill Long 0x1000 .. +7=' abcdefgh' 



To compare two blocks of memory 

• Using the command line, enter: 

Memory Block_Operation Match <Mismatch_Operation> 

Select either Repeat_On_Mismatch or Stop_On_Mismatch to specify what happens 
when a mismatch is found, enter the address range to be compared and the starting 
address of the range that it is compared to; then, press the <Return> key. 



Example To compare the block of memory starting at address lOOOh and ending at address 

lOffh with a block of the same size beginning at address 5000h and stop when a 
difference is found: 

Memory Block_Operation Match Stop_On_Mismatch 
lOOOh. .10ffh,5000h 



198 



Chapter 6: Editing Code and Data 
To re-initialize all program variables 

To re-initialize aii program variables 

• Select File^Load^Program Only then use the File Selection dialog box to 
select the absolute file. 

Or: 

• Using the command line, enter: 

Program Load New Code_only No_Pc_Set <absolute_naine> 

Enter the name of the absolute tile whose code is to be loaded, and press the 
<Return> key. 

The code will be loaded without loading symbols or resetting the PC. 

The debugger does not save the initial values of variables. The only way to restore 
the initial values is to re-load the program. After re-loading the program, you may 
need to restore some debugger settings; for example, you might need to re-specify 
variables for the Monitor window. 



To change the contents of a register 

• Select Modify^R^ster. This will display the Modify Register dialog box. 
Or: 

• Using the command line, enter: 
Memory Register 

On the command line, enter the name of the register and the value to which the 
register's contents should be changed, and press the <Retuni> key. 

Registers may also be modified by using "©register" in a C_expression. 
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Example 



To modify register values interactively: 



Memory Register 

The program counter PC is displayed in the journal window. You can modify the 
PC by entering a value (10a4h in this example) at the cursor prompt and pressing 
<Retum>. The PC will be modified, and the next register will be displayed: 



Press <Return> without entering a value to exit this mode. 
To set the value of register @dl to 44h: 
Memory Register @dl=0x44 

To interactively change the value of register @dl: 
Memory Register @dl 



@pc 
@sp 



= OxOOOOlOBS 
= 0x00015DB4 



4280: 10a4h 

89524 : 



200 



7 




Using Macros and Command Files 

How to use macros and command files to make debugging easier. 
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The debugger provides several ways for you to simplify tasks that you do often. 

• Macros are C-Uke functions. You can call macros individually, attach them to 
breakpoints, or automatically execute them with each program step. Macros 
are especially useful for temporarily patching C code. 

• Command files contain series of debugger commands. The debugger can read 
a command file and execute the commands found there as if they were entered 
directly into the interface command line. Command files are useful for setting 
up the debugger, for executing a program to a certain point, and for automated 
testing. 

• Action keys are shortcut definitions or "hotkeys" which allow you to add new 
commands to the graphical interface. Action keys are useful for simphfying 
frequently-used commands, for making the debugger easier to use for 
co-workers who do not frequently use a debugger, and for making the 
debugger into a framework for demos and tutorials. 
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Using Macros 

A macro is a C-like function consisting of debugger commands and C statements 
and expressions. 

Macros are most often used to: 

• Patch C source code. 

Often, bugs found with the debugger can be temporarily patched with C source 
statements in macros. You do not have to exit the debugger, edit the source 
code, recompile and Unk, and then reenter the debugger. Instead, you can 
make a temporary patch by using breakpoint macros. 

• Return values to expressions. 

• Create conditional breakpoints. 

• Execute commands after each program step command. 

• Execute a set of commands. 

Macros can: 

• Have input parameters (macro arguments). 

• Define macro local variables. 

• Contain C statements and expressions. 

• Refer to target variables and registers. 

• Refer to user-defined variables. 

• Have retum values. 

• Call other macros. 

• Can be used in expressions (if they retum values). 

• Execute most debugger commands. 

Macros cannot: 

• Define global variables. 

• Define static variables. 

• Be recursive. 

• Define other macros. 

• Contain the conditional operator (expression ? expression : expression). 
Macros can be called: 

• By specifying the macro name in an expression. 

• By calling the macro from within another macro. 

• With the Debugger Macro Call command. 

• With the Breakpt command. 

• With the Program Step With_Macro command. 
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This section shows you how to: 



• 


Define a macro. 


• 


Call a macro. 


• 


Stop a macro. 


• 


Display macro source code. 


• 


Patch C source code by using macros. 


• 


Delete a macro. 



Saving and re-using macros 

You can define and save macros interactively during a debugger session. 
Macro limits 

The maximum number of characters that can be entered on a hne in a macro 
definition is 255. When entering macro interactively, the debugger does not 
respond to more than 78 characters on a line. When reading a command file, the 
debugger stops recognizing characters after 255 characters have been read on a line. 

The maximum number of lines allowed in a macro depends on the complexity of 
the lines. Macros with too many lines (too complex) will fail. Error 92 "Not 
enough memory for expression" will be displayed. 

A maximum of 40 parameters may be specified in a macro definition. 

Once you have defined a macro, you can use it any time during the debugging 
session, whenever that set of commands or statements is needed. 



Caution The pseudoregister ©cycles is not implemented in the emulation enviroimient. 

Macros written for execution in both the simulation and emulation enviroimients 
must not refer to ©cycles. 



Macro comments 

Macros support C comments (introduced by the characters/* and terminated with 
the characters */). 
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Macro arguments 

You can use formal macro arguments throughout the macro definition. They are 
replaced at execution time by the actual parameters present in the macro call. The 
actual parameter is coerced to the corresponding formal parameter type. If 
coercion is not possible, an error occurs. 

You must hst the macro' s arguments (if any), along with their associated types, 
when you define the macro. For example, the following Usting defines arguments 
for the built-in macro strcpy(): 

Debugger Macro Add int strcpy (target, source) 
char *target ; 
char *source; 

Macro variables 

Variables that are local to the macro may be created within the macro. The 
definition of local variables follows the rules of C, with the exception that you 
cannot define variables with initializers. Variables may be defined to have a 
simple type, or they may be of type array or pointer. Derived types (such as 
structures and unions), enumerated types, and typedefs are not legal within macros. 

The macro processor does not recognize the C keywords extern, auto, static, and 
register. The macro processor reports an error if these C keywords are used. Static 
variables are not scoped within a macro. However, symbols created with the 
Symbol Add command (debugger symbols) are globally scoped, and can be 
accessed from within a macro. Register variables (such as @PC) may also be 
accessed from within a macro. 

Target program symbols can also be accessed from within a macro. Variables 
which are globally scoped within the target program can be accessed directly. File 
static, function static, and automatic variables can be accessed directly only if the 
current context of the debugger is the module or function in which they are scoped. 
Otherwise, they require a module or function name as a qualifier before they can be 
accessed. For example, assume the following definition exists in your target 
program, in a file called init.c: 

static int i; /* file static */ 

foo(int parm) 
{ 

static int j; /* function static */ 

auto int k; /* function local */ 

}" 
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If a macro is executed while the PC is pointing into the function foo(), variables i, j, 
and k can be direcdy accessed. If this is not the case, i must be accessed with a 
module qualifier, such as init\i. The function static j must be accessed as init\foo\j. 
The automatic k can be accessed as init\foo\k if the stack frame for foo() is aUve. 

Macro control flow statements 

Macros support the following C control flow statements: 

• If-else 

• While and For 

• Do-while 

• Break and Continue in While, For, and Do statements. 
However, macros cannot contain conditional expressions of the form: 
<expression>?<expression> : <expression> 

Macro return values 

Macros support the C "return" statement for returning values. 

If a breakpoint macro returns a nonzero value, program execution continues. If it 
retums a zero value, program execution is halted. If a macro does not return a 
value, it should be declared as void when it is defined. 

Macros containing debugger commands 

You can create macros that contain only a sequence of debugger commands. 
Macros containing only debugger commands are similar to command fUes. You 
can use these macros to set up complex initialization conditions. 

You cannot use the following commands in macros: 

• Program Run 

• Program Step 

• Program Step Over 

• Debugger Host_Shell 

• Debugger Macro Add 

• Symbol Add 

• Symbol Remove 

• File Command 

• Debugger Quit 
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To display the Macro Operations diaiog box 

• Select Breakpoints^Edit/Call Macro from the menu bar. 
Or: 

• Select Attach Macro from the Code window pop-up menu. 

The Macro Operations dialog box allows you to caU predefined macros, edit or call 
existing user-deiined macros, and create new macros. 



To define a new macro interactively using the 
graphical interface 

1 Display the Macro Operations dialog box. 

2 Move the mouse pointer to the Selected Macro entry area. 

3 Type <Ctrl>-U to clear the Selected Macro entry area, then type the name of the 
macro you wish to create. 

When you press <Retum> or click on the Edit button, the debugger will display 
an editor window. 

A "skeleton" macro will appear in the editor window. 

4 Edit the macro definition. 

When you exit the editor, save the macro under the default name. If you save it 
under a different name, the macro may be lost. 

See Also See "To use an existing macro as a template for a new macro" if you want to use an 

existing macro as the basis for a new macro. 
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Example To create an macro called "test_macro", select Breakpoints^Edit/Call Macro 

and enter "test_macro" in the Selected Macro area. Now press <Return> or click 
on the Edit button. Edit the macro in the editor window. If you are using the vi 
editor, exit using the "ZZ" command. The new macro should now appear at the end 
of the Defined Macros Ust. 



To use an existing macro as a template for a new 
macro 



1 Display the Macro Operations dialog box. 

2 In the dialog box, select the macro you wish to use as a template. 

3 CUck on the Edit button. 

4 In the editor, change the name of the macro. 

Now you may edit the parameters and body of the macro. 

When you exit the editor, the macro will be saved under the new name. The 
original macro will not be changed. 



To define a macro interactively using the 
command line 

1 Enter the Debugger Macro Add command followed by an optional return type, and 

then a macro name. The macro name must be followed by parentheses; the 
parentheses can optionally enclose macro arguments separated by commas. 

Debugger Macro Add [<type>] <naine> ([parm, parm, . . .]) 
[<parm_types>; ] 
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2 Enter the text of the macro body. 
{ 

[ [<C_expr> I <C_stmt> | $«iebugger_cand>$] ; . . . ] 

} 

3 End the macro definition with a period as the first and only character on a line. The 
macro is checked for syntax errors as soon as the period is encountered. If an error 
is found within a macro, the macro definition is not saved. The macro must be 
completely reentered. 

Your completed macro definition should have the following syntax: 

Debugger Macro Add [<type>] <naine> ( [parm, parm, . . . ] ) 

[<pann_types>; ] 

{ 

[ [<C_expr> I <C_stmt> | $<debugger_cand>$] ; . . . ] 

} 

Debugger commands can be embedded in the macro by enclosing the commands 
between $ characters. For example, 

$Expression C_Expression @PC = #31$; 

No standard C Ubrary functions are available from within a macro. However, there 
are built-in macros available in the debugger that perform similar functions (refer 
to the "Predefined Macros" chapter). 



To define a macro outside tlie debugger 

1 Using a text editor on your host system, define the macro. 

2 Save the macro definition in a command file (<filename>.com). 

3 Start the debugger. 

4 Load the command file into the debugger using the File Command command. 
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As the macro is loaded into the debugger, the macro processor parses the macro, 
looking for syntax errors. If the macro definition contains no errors, it is loaded 
into the debugger's symbol table. 

If an error is detected, the macro processor reports the error and quits loading the 
command file. The macro remains undefined. 

The number of macros that you can define is limited only by the available memory 
on your host computer system. 



To edit an existing macro 

• If you want to edit a macro attached to a breakpoint, select Edit Attached Macro 
from the Code window pop-up menu. 

Or: 

1 Display the Macro Operations dialog box. 

2 Select the macro you want to edit. 

3 Click on the Edit button. 

Remember to save the macro under the default file name when you leave the editor 
(use the "ZZ" or ":wq!" command in vi). 



To save macros 

• Select File^Store^User-Defined Macros.... 

The File Selection dialog box will be displayed so that you can choose a file in 
which to save the macros. The debugger will automatically add a. com extension 
to the file name. 
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The debugger will save all of the your user-defined macros to a file. 

The debugger does not provide a way to save only selected macros. If you want to 
save macros in separate files, you can create the macros using a text editor. 



To load macros 

• Select File^Load^User-Defined Macros.... 

Choose the macro file to load from the File Selection dialog box. 



If macros do not load 

n Check that the macros do not directly access local program variables. 

When the debugger loads macros which access local program variables, the 
debugger does not know which local scope to use to define the macro. 

If you need to access local program variables in a macro, pass them to the macro as 
parameters. 

To call a macro 

• Select Breakpoints^Edit/Call Macro ...^Call. 

Or: 

• Using the command line, enter: 

Debugger Macro Call 
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Enter the name of the macro to be called, and press the <Return> key. 

When a macro is called with the Debugger Macro Call command, its return value is 
ignored. Macros are typically called in this manner for the side effects they 
generate. 



Example If you have the following macro definition: 

Debugger Macro Add void stackchk ( ) 
{ 

/* The symbols 'stack' and 'TopOfStack' exist in the compiler's */ 
/* environment library, and are addresses which indicate the */ 
/* bottom and the top of the system stack. The symbol @sp is a */ 
/* debugger reserved symbol which contains the current value of */ 
/* the processor's stack pointer. */ 

$Expression Printf "%d bytes of stack used", TopOfStack - @sp$; 
$Expression Printf "%d bytes of stack available", @sp - stack$; 

} 



the command: 

Debugger Macro Call stackchk () 

displays, in the journal window, the amount of stack used and the amount of stack 
left. 



To call a macro from within an expression 



• Enter a macro call as part of any expression entered on the command line of the 
debugger. 

The debugger will evaluate the macro and use its retum value when evaluating the 
rest of the expression. 



If you have the following macro definition: 

Debugger Macro Add int power (x,y) 
int x; 
int y; 
{ 

int i; /* Loop counter */ 

int multiplier; /* Value x is multiplied by */ 



Example 



212 



Chapter 7: Using Macros and Command Files 

Using Macros 



/* Multiply X by itself y -1 times */ 
for (i = 1, multiplier = x; i < y;i++) 
X *= multiplier; 

/* Return x "y */ 
return x; 

} 



The command: 

Expression DisplaY_Value 33.3 + power (2, 3) 

will call and evaluate the macro, displaying the value 41.3 in the debugger's 
journal window. 



To call a macro from within a macro 

• You can call a macro from within a macro when they are part of an expression. 

The following restrictions apply to calling macros from within a macro: 

• The macro called must have been previously defined. 

• The macro cannot call itself. 

Example If you have the following macro definition: 

Debugger Macro Add int ten_to_the (y) 

int y; 

{ 

return power (10, y); ) 

the macro will compute 10**y by calling the previously defined macro power{). 
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To call a macro on execution of a breakpoint 

• Select Attach Macro from the Code window pop-up menu. 
Or: 

• When using the command hne to set a breakpoint, add a semicolon (;) and the 
name of the macro to the command. 

When setting breakpoints, you can attach a macro to the breakpoint. Whenever the 
breakpoint is encountered, the macro is executed. Depending on the return value of 
the macro, program execution will either stop or continue. 

• If the macro returns zero, program execution stops at the breakpoint. 

• If the macro returns a nonzero value, program execution continues at the 
breakpoint. 

Macros attached to breakpoints can test program or user-defined variables before 
determining whether execution should break or not (by returning zero or nonzero 
values, respectively). 

Macro control flow statements within a breakpoint macro can alter execution flow 
in the target environment based on target or debugger variable values. You can 
also include C expressions in macros. By using control flow statements and C 
expressions in macros, you can patch your C programs. 



Example The following example shows how return values can be used to conditionally 

control a breakpoint. The example uses the Debugger Macro Add and Breakpt 
Write commands to detine a breakpoint that occurs only when the target variable 
days becomes greater than 3 1 . 

Debugger Macro Add int daycheck() 
{ 

if (days > 31) 
return 0; 

else 

return 1; 

} 

Breakpt Write &days ; daycheck ( ) 
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When the break occurs, the macro is executed. If days is less than or equal to 31, 
program execution continues. If days is greater than 31, program execution stops. 

If you have the following macro definition: 

Debugger Macro Add Int break_when (stopf unction, mln, max) 

char *stopfunction; 

int min ; 

int max ; 

{ 

/* Debugger symbol gfunction is a char pointer to the name */ 
/* of the current function. Conpare the current function */ 
/* with the function name passed, using the built— in macro */ 
/* memento . */ 

if ( ! strcmp (@f unction, stopfunction) ) 

if ( (global_var > min) && (global_var <max) ) 

{ 

$Expression Printf "global_var: %d\n", global_var$; 
return 0; 

} 

/* Not in specified function, return 1 so that program will */ 
/* continue executing. */ 
return 1; 

} 



the command: 

Breakpt Write &global_var; break_when ( " f oo" , 256,512) 

will set a write breakpoint on the global variable global_var. Whenever the 
program writes to global_var, the macro break_when( ) is executed with the 
parameters "foo", 256, and 572. The macro returns the value 1 until the value of 
global_var falls between 256 and 512 because of a write to global_var'm the 
function/oofj. The macro then retums 0, causing the program to halt. 



To call a macro when stepping through programs 

• Select Execution^Step^with Macro .... 

Or: 
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• Using the command line, enter: 

Program Step With_Macro 

Enter the name of the macro to be called, and press the <Return> key. 

You can use the Program Step With_Macro command to execute a macro after the 
step occurs. Calling a macro in this manner is useful in tracking down subtle bugs. 



Example If the function /oof ) was corrupting automatic variables index and ch on the stack, 

the following macro and commands could be used to identify the Une where the 
corruption was occurring: 

Debugger Macro Add void auto check ( ) 
{ 

if ((index < 0 | | index > 80) | | (ch < 32 | | ch > 126)) 
{ 

$Window Screen_On High_Level$; 

$Expression Printf "Autos corrupted! !! \n"$; 

$Expression Printf "index: %d ch: %c\n", index, ch$; 

} 

} 

Program Run Until foo 

Program Step With_Macro auto_check() 



To stop a macro 

• Press <Ctrl>-C. 

Macros can be halted during execution by pressing <Ctrl>-C. 



Caution <Ctrl>-C will stop execution of a macro. Pressing <Ctrl>-C may interrupt a 

code-patching macro before it completes execution. If this occurs, you cannot 
restart program execution within the macro where it stopped. 
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To display macro source code 

• Choose Edit in the Macro Operations dialog box. 
Or: 

• Using the command line, enter: 

Debugger Macro Display <inacro_name> 

Enter the name of the macro you want to display, and press the <Return> key. 

This command will write the macro source to the journal window. If you want to 
write the macro source to a user-defined window or to a file, you can specify an 
optional user window number as the destination. 

Example To write the source for macro auto_check() to user window 51 : 

Debugger Macro Display auto_check: ( ) ,51 



To delete a macro 

• Using the command line, enter: 

Symbol Remove <macro_name> 

Enter the name of the macro you want to delete, and press the <Return> key. 
Use the Breakpt Delete command to remove the breakpoint that called the macro. 
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Using Command Files 

A command file is an ASCII file containing debugger commands. 

You can create command files from within the interface by logging commands to a 
command file as you execute the commands, or you can create or modify command 
files outside the interface with an ASCII text editor. 

The debugger can read a command file and execute the commands found there as if 
they were entered directly into the interface command line. 

Command files can also call other command files and the interface will execute the 
called file like a subroutine of the calling file. 

This section shows you how to: 

• Record commands. 

• Place comments in a command file. 

• Pause the debugger. 

• Stop command recording. 

• Run a command file. 

• Set command file error handling. 

• Append commands to a command file. 

• Record commands and results to a journal file. 

• Stop recording commands and results to a journal file. 

• Open a file or device for read or write access. 

• Close the file associated with a window number. 

• Use the debugger in batch mode. 
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To record commands 

• Use the -1 command Jile option to the db68k command when starting the debugger. 
(The debugger appends the file extension .com to command Jile.) 

$ db68k -e <emulator_id> -1 <command_f ile> <RETURN> 
Or: 

• Select File^Log^Record Commands. Using the file selection dialog bog, enter 
the name of the file to which the commands will be saved, and cUck on the OK 
pushbutton. 

Or: 

• Using the command line, enter: 
File Log On 

Enter the name of the file to which commands will be saved, and press the 
<Retum> key. 

All commands, whether they are entered from the menus or the command line, are 
recorded to the log file. If a command causes an error, both the command and the 
error code are recorded as comments. 

Example To start logging commands to file "cmdfUel .com": 

File Log On cmdfilel 



To place comments in a command file 

• Using the command line, enter: 

File Log Comment 
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Enter the comment that should be placed in the command file, and press the 
<Retum> key. 

In the command file, the comment is prefixed with a semicolon (;). 

When editing command files, you can also use C-style comments (introduced by 
the characters /* and terminated with the characters */). 



Example To place the comment "Place this comment in a command file." in the command 

file: 

File Log Comment Place this comment in the command file. 



To pause the debugger 

• Using the command line, enter: 

Debugger Pause 

And press the <Retum> key. 

The debugger is paused until you enter the spacebar. 

You can also specify that the debugger pause for a number of seconds by using the 
Debugger Pause Time command. 

The Debugger Pause commands are useful when executing command files. 



To stop command recording 

• Select File^Log^Stop Command Recording. 

Or: 
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• Using the command line, enter: 

File Log oFF 

And press the <Return> key. 

The command file is closed. 



To run a command file 

• Use the -c commandjile option to the db68k command when starting the 
debugger. (The commandjile must end with the .com extension.) 

$ db68k -e <emulator_id> -c <command_f ile> <RETURN> 
Or: 

• Select File^Log^Playback. Using the file selection dialog box, enter the name 
of the command file, and click on the OK pushbutton. 

Or: 

• Using the command line, enter: 

File Command 

Enter the name of the command file from which debugger commands will be 
executed, and press the <Return> key. 

The debugger will begin executing commands found in the command file as if 
those commands were entered directly into the interface. The debugger will 
continue to execute commands until it reaches the end of the file or, perhaps, until 
an error occurs, depending on the command file error handling mode (see "To set 
command file error handling"). 
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To intemipt playback of a command file, press the <Ctrl>-c key combination. (If 
the graphical interface is being used, the mouse pointer must be within the interface 
window.) 

Example To start executing command from the file "cmdfilel.com": 

File Command cmdfilel 

See Also File Startup in the "Debugger Commands" chapter 



To set command file error handling 

• Using the command line, enter: 

File Error_Command <Handling_Mode> 

Select either Abort_Read, Continue_Read, or Quit_Debugger error handling mode, 
and press the <Return> key. 

When an error occurs while executing a command file: 

Abort_Read causes the debugger to stop reading the command file. 

Continue_Read causes the debugger to continue executing the command file 
with the next command. 

Quit_Debugger causes the debugger session to end. 
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To append commands to an existing command 
file 

• Using the command line, enter: 
File Log Append 

Enter the name of the file to which commands will be appended, and press the 
<Retum> key. 

Example To append command to the file "cmdfilel.com": 

File Log Append cmdfilel 



To record commands and results in a journal file 

• Use the -] journal Jile option to the db68k command when starting the debugger. 
(The debugger appends the file extension .jou to journal Jile.) 

$ db68k -e <emulator_id> -j < journal_f ile> <RETURN> 
Or: 

• Select File^Log^Record Journal. Enter the name of the file to which the 
commands and results wiU be saved, and click on the OK pushbutton. 

Or: 

• Using the command line, enter: 
File Journal On 

Enter the name of the file to which commands and results will be saved, and press 
the <Return> key. 
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Journal files are similar to command files. They contain debugger commands 
entered during a debug session. Journal files also contain any output generated by 
debugger commands. Journal files contain everything that is written to the journal 
window during a debug session. 



Example To start recording commands and results to file "joumall.jou": 

File Journal On journall 



To stop command and result recording to a 
journal file 

• Select File^Log— >Stop Journal Recording. 

Or: 

• Using the command line, enter: 

File Journal oFF 
And press the <Retum> key. 



To open a file or device for read or write access 

• Using the command line, enter: 
File User_Fopen 

Select the open option, window number, and file name; then, press the <Retum> 
key. 
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After opening a file using the File User_Fopen Append or File User_Fopen Create 
command, you can use the Expression Fprintf command to write information to the 
fUe. Files opened for reading may be read from the built-in macro fgetc(). See the 
"Predefined Macros" chapter of this manual for a complete description of this 
macro. 

The window number must be between 50 and 256 inclusive. 

Use the Window Delete or the File Window_Close command to close the fUe. 



Example To open user window 57 and redirect any data written to window 57 to the file 

'varTrace.out': 

File User_Fopen Create 57 File varTrace.out 



To close the file associated with a window 
number 

• Using the command line, enter: 

File Window_Close 

Enter the window number associated with the file when it was opened, and press 
the <Return> key. 



Example To close the fUe associated with user window number 57: 

File Window_Close 57 
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To use the debugger in batch mode 

• Use the -b and -c command Jile options to the db68k command when starting the 
debugger. 

When using the debugger in batch mode, stdin, stdout, and stderr are disabled. The 
-b option must be accompanied by the -c option and a debugger command file. All 
commands are read from the command file. No user interaction with the debugger 
is allowed. In batch mode, the debugger can be executed as a background process. 
This mode is commonly used for automatic testing. 



Example 

$ db68k -b -e <emulator> -c <coinmand_f ile> 
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8 



Configuring the Debugger 

How to cliange the appearance and beliavior of tlie debugger. 
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Configuring tlie debugger 

These tasks are grouped into the following sections: 

• Setting the general debugger options. 

• Setting the symbolics options. 

• Setting the display options. 

• Modifying display area windows. 

• Saving and loading the debugger configuration. 

• Setting X resources. 

Some options can be set using either the Debugger Options dialog box or the 
command line. Other options can be set only using the command hne. 
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Setting the General Debugger Options 

This section describes how to: 

• Display the Debugger Options dialog box. 

• List the debugger options settings. 

• Change debugger options settings. 



To display the Debugger Options dialog box 

• Select Settings^Debugger Options from the menu bar. 

You can change settings in the Debugger Options dialog box by clicking on the 
appropriate buttons. 



To list the debugger options settings 

• Select Settings^Debu^er Options ... 

You can also look at most debugger option settings by examining the Debugger 
Options dialog box. 
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To change debugger options settings 

• Use the Debugger Options dialog box. 
Or: 

• Use the command Une. 

See Also The "Debugger Option" sections in the "Debugger Commands" chapter for 

information on using the command Une to set debugger options. 



To specify whether command file commands are 
echoed to the Journal window 

• Using the command line, enter: 

Debugger Option Cominand_Echo 
Select On or Off, and press the <Retum> key. 

On Command file commands are echoed to the Journal window. 

Off Command file commands are not echoed to the Journal window. 
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To set automatic alignment for breakpoints and 
disassembiy 

• In the Debugger Options dialog box, click on the Ahgn Breakpoints button to 
toggle alignment. 

On Debugger automatically aligns breakpoints or locations to be 

displayed in mnemonic format to the beginning of instructions. 

Off Breakpoints are not automatically aligned. 

Off is the recommended setting because of software break instruction replacement. 



To set backtrace display of bad stack frames 

• In the Debugger Options dialog box, cUck on the Frame Stop button to toggle 
display of bad stack frames. 

On Only consecutive vaUd stack frames are displayed. 

Off All stack frames, including bad frames, are displayed. 



To specify demand loading of symbols 

• In the Debugger Options dialog box, cUck on the Demand Loading button. 
On Symbol information is loaded on an as-needed basis. 

Off All symbol information is loaded. 
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The -doff command-line option overrides the On setting when the settings are 
saved in a startup fUe. 



To select the interpretation of numeric literals 
(decimal/hexadecimal) 

• In the Debugger Options dialog box, hold the command select mouse button down 
on the button for "Input Radix" or "Output Radix". Release the button to select 
"Decimal" or "Hex". 

If you select Hex, input and output values are interpreted as hexadecimal for 
assembly-level references. Any assembly-level number you want interpreted as 
decimal must be terminated with a T (for example, specify 32 as 32T). 

Even if you select Hex, the following inputs wiU not be interpreted as hexadecimal: 

• Line numbers starting with "#". 

• Variables in high-level expressions, including C_Expression and macro 
expressions. To cast a high-level expression as hexadecimal, use a leading 
"Ox" or a trailing "h". 

• Debugger variables including: 

- breakpoint numbers, 

- viewport numbers, and 

- data viewport line numbers. 

Binary numbers are not available when you select Hex. 
Floating point and enumeration type values are not affected. 
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To specify step speed 

• Using the command line, enter: 

Debugger Option General Step_Speed <numb 0..100> 
Enter the step speed number (from 0 to 100), and press the <Return> key. 
Higher numbers represent slower speeds. 
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Setting the Symbolics Options 

This section shows you how to: 

• Display symbols in assembly code. 

• Display intermixed C source and assembly code. 

• Control case-sensitivity for symbols and module names. 



To display symbols in assembly code 

• In the Debugger Options dialog box, chck on the Assembly Symbols button to 
toggle assembly symbol display. 

Select On or Off, and press the <Return> key. 

On Symbols are displayed instead of addresses wherever possible. 

Off Addresses are displayed. 



To display intermixed C source and assembly 
code 

• In the Debugger Options dialog box, click on the Intermixed Source/Assembly 
button to toggle source display. 

On Assembly code is intermixed with C source code. 

Off Only C source code is displayed. 
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To convert module names to upper case 

• In the Debugger Options dialog box, click on Uppercase Module Names. 



To control case sensitivity of symbol lookups 

• In the Debugger Options dialog box, select one of the following values for Symbol 
Lookup: 

As Entered Only The debugger will always look up the symbol as entered, 

case sensitive. 

As Entered & Upper The debugger will look up the symbol as entered. If this 
fails, the debugger will convert the symbol to upper case 
and try again. 

As Entered & Lower The debugger will look up the symbol as entered. If this 
fails, the debugger will convert the symbol to lower case 
and try again. 

As Entered, Upper & The debugger will look up they symbol as entered. If this 
Lower fails, the debugger will convert the symbol to lower case 

and try again. If this fails, the debugger will convert the 

symbol to upper case and try again. 
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Setting the Display Options 

This section shows you how to: 

• Specify the Breakpoint, Status, or Simulated I/O window display behavior. 

• Display half-bright or inverse video highlights. 

• Display information a screen at a time (more). 

• Specify scroll amount. 



To specify the Breakpoint window display 
behavior 

• In the Debugger Options dialog box, hold the command select mouse button down 
on the Breakpoint Window button. Release the button to select On or Swap. 

On The Breakpoint window is displayed at all times. 

Swap The Breakpoint window is only displayed when you set or 

delete a breakpoint or when you display breakpoints. 



To specify the Breakpoint, Status, or Simulated 
I/O window display behavior 

• In the Debugger Options dialog box, under View Options, select On or Swap. 
On The window is displayed at all times. 

Swap The window is only displayed when you activate the window or 

when the debugger updates the information in the window. 
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Off (Simulated I/O window only) The Stdio window is only 

displayed when function key F6 is pressed or when the 
Window Screen_On Stdio command is entered. 



To display half-bright or inverse video highlights 

• Using the command line, enter: 

Debugger Option View Highlight 

Select Half_Bright or Inverse, and press the <Retum> key. 

This setting does not affect the graphical user interface. 



To turn display paging on or off (more) 

• In the Debugger Options dialog box, hold the command select mouse button down 
on the More List Mode button. Release the button to select On or Off. 

On Information is listed one screen at a time. 

Off Information is listed all at once. 



To specify scroll amount 

• Using the command line, enter: 

Debugger Option View Aint_Scroll <numh 0..50> 
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Enter the number of lines for information to be scrolled (from 0 to 50), and press 
the <Retum> key. 



To store timing information when tracing 

• In the Debugger Options dialog box, select a Trace Counts option. 

Time Use half of trace memory to store timing information. 

Nothing Use all of trace memory to store bus states. 

The debugger trace display does not display timing information, but it may be 
viewed in the emulator/analyzer interface. 

You cannot use the debugger interface to make trace measurements with the 
HP Softwre Probe. 



To masl( fetches while tracing 

• In the Debugger Options dialog box, select a Fetch Mask option. 

Fetch addresses will be masked to the selected boundary size. 

This feature is useful when a processor has a larger data bus size than its instruction 
fetch size. For instance, the 68020 has a 32-bit data bus, but instructions may be 
located at 16-bit boundaries, hi this case, set the aligrmient to Long. For example, 
an instruction starting at address 0x402 wiU be fetched by a bus access at 0x400. 
Unless fetch addresses are masked to Long, the fetch of the instruction at 0x402 
would not be seen. 

This mask only applies to trace triggers specified with a status cycle type of fetch 
such as those specified by the pop-up menu in the Code window. 

You cannot use the debugger interface to make trace measurements with the 
HP Softwre Probe. 
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Modifying Display Area Windows 

You can reformat display-area screens by modifying their windows. For example, 
you can reformat the high-level screen by resizing and moving the high-level Code, 
Monitor, Backtrace, Journal, and Breakpoint windows. You can also resize and 
move the altemate view of these windows. 

This section shows you how to: 

• Resize or move the active window. 

• Move the Status window (standard interface only). 

• Define user screens and windows. 

• Display user-defined screens. 

• Erase standard I/O and user-defined window contents. 

• Remove user-defined screens and windows. 



To resize or move the active window 

1 Using the command line, enter: 

Window Resize 

And press the <Return> key. 

2 Type T to position the top-left comer, B to position the lower-right comer, or M to 
move the window without resizing it; then, use the cursor keys to move the window 
or window border. When the window is at the desired location, press the 
<Retum> key to save the new coordinates. 

If you make a mistake while resizing the window, press CTRL C or press Esc 
twice to restore the previous coordinates. 
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The Window Resize command is used to move or alter the size of any existing 
window, except for the Status window. Use the Window New command to move 
the Status window in the standard interface. 

When you use the Window Resize command on the normal view of a window, the 
normal dimensions are modified. When you use the command on the altemate 
view of a window, the alternate dimensions are modified. 

You can enter resize commands when any screen is displayed. However, the 
debugger does not display commands on the standard I/O screen or on any 
user-defined screen. 



To move the Status window (standard interface 
only) 

The Status window cannot be moved in the graphical interface. 
1 Using the command line in the standard interface, enter: 
Window New 

Specify window number 5 to move the high-level Status window (or window 
number 15 to move the assembly level Status window), select Tab followed by 
High_Level (or Assembly), enter the new coordinates for the Status window, and 
press the <Return> key. 

The Status window carmot be resized. The difference between the bottom row 
coordinate and top row coordinate must be 3. 

A high-level program must be loaded in order to move the high-level status screen. 

Be sure to move any windows that occupy the screen area to which you are moving 
the Status window. Otherwise, the Status window will be hidden behind these 
windows. 



Examples To move the high-level Status window to the top of the display (upper left comer at 

0,0 and lower right corner at 3,78): 

Window New 5 <tab> High_Level 0,0,3,78 
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To move the assembly-level Status window to the bottom of the display: 
Window New 15 <tab> Assembly 19,0,22,78 



To define user screens and windows 

• Using the command line, enter: 
Window New 

Enter the window and screen parameters, and press the <Retum> key. 

The debugger lets you define your own screens and windows so that you have 
flexibility in displaying debugger information. 

User-defined windows must be assigned a number greater than or equal to 50, and 
less than or equal to 256. Numbers below 50 are reserved for predefined debugger 
screens and windows. 

When you make a new window with the Window New command, the normal view 
and alternate view dimensions are set identically. The debugger allocates a buffer 
with enough memory to contain the entire window. Therefore, the window with 
the largest dimensions (normally the altemate view) should be defined first to 
allocate sufficient memory. 

To display a user-defined screen, use the Window Screen_On command or 
press function key F6. 



Caution When making a new window on the high-level or assembly-level screens, be 

careful not to enter coordinates that will result in a window that covers the status 
line and command line. On a standard 80-column terminal display, a row 
coordinate may be between 0 and 23. Creating a window with a bottom row 
coordinate greater than 18 will cause part or all of the status and command lines to 
be covered. 
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Examples To make a user window numbered 57 in user screen 4 with the upper-left comer of 

the window at coordinates 5,5 and the lower-right comer of the window at 
coordinates 18,78: 

Window New 57 <tab> User_Screen 4 <tab> Bounds 5,5,18,78 
If user screen 4 does not exists, the debugger automatically creates it. 



To display user-defined screens 

• Using the command line, enter: 

Window Screen_On User_Screen <screen_nmbr> 
Enter the user screen number, and press the <Retum> key. 

Examples To display user screen 4: 

Window Screen_On User_Screen 4 



To erase standard I/O and user-defined window 
contents 

• Using the command line, enter: 

Window Erase <user_window_nmbr> 

Enter the user window number (the standard I/O window number is 20) whose 
contents you wish to clear, and press the <Return> key. 

If you do not specify a window number or if you specify 0, the active user-defined 
window is cleared. This command is useful in macros. 
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Examples To erase the contents of user window 57: 

Window Erase 57 



To remove user-defined screens and windows 

• Using the command line, enter: 

Window Delete <user_window_nmbr> 

Enter the number of the window to be removed, and press the <Retum> key. 
To remove a user-defined screen, remove all windows associated with that screen. 
You cannot remove predefined debugger windows and screens. 

Examples To remove a user-defined screen that has three windows (numbers 50, 55, and 73): 

Window Delete 50 

Window Delete 55 
Window Delete 73 
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Saving and Loading tlie Debugger Configuration 

Information regarding debugger options and screen configurations can be saved in 
a startup file. Startup files can be created only from within the debugger. 

This section shows you how to: 

• Save the current debugger configuration. 

• Load a startup file. 



To save the current debugger configuration 

• Use the menu select mouse button to choose File— >Store— ^Startup (.re) file (as 
default). The information is saved in file "db68k.rc" in the current directory. 

Or: 

• Use the menu select mouse button to choose File^Store^Startup (.rc) file. 

Using the file selection dialog box, enter the name of the file to which startup 
information should be saved; then, cUck on the OK pushbutton. 

This command also saves the window and screen settings. 

When saving window and screen settings that have been customized for a 
particular type of terminal, name the startup file the same as the TERM 
environment variable setting. If no startup file is loaded when starting the 
debugger, the debugger will automatically search for startup files named 
"./$TERM.rc" (in the current directory) or "$HOME/.$TERM.rc" (in the home 
directory), files. 
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To load a startup file 

• Use the -s startup Jile option to the db68k command when starting the debugger. 

$ db68k -e <emulator_id> -s <startup_f ile> <RETURN> 

The debugger's startup options and window specifications are configured as 
described in startup Jile. 

The startup Jile must end with the .rc extension and can be created only from 
within the debugger. 

If no startup file is named, the following files are searched for in order. The first 
one that exists will be used ($HOME and $TERM are UNIX environment 
variables). 

db68k. rc in the current directory 
. /$TERM. rc in the current directory 

$HOME/ . $TERM.rc 

If no startup file is found, reasonable defaults will be used. 



Examples To start the debugger and load the state saved in the startup file "my_state.rc": 

$ db68k -e emul68k -s mY_state.rc <RETURN> 
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Setting X Resources 

The debugger's graphical interface is an X Window System apphcation which 
means it is a client in the X Window System client-server model. 

The X server is a program that controls all access to input devices (typically a 
mouse and a keyboard) and all output devices (typically a display screen). It is an 
interface between application programs you run on your system and the system 
input and output devices. 

An X resource controls an element of appearance or behavior in an X application. 
For example, one resource controls the text in action key pushbuttons as well as the 
action performed when the pushbutton is clicked. 

By modifying resource settings, you can change the appearance or behavior of 
certain elements in the graphical interface. 

Where resources are defined 

When the graphical interface starts up, it reads resource specifications from a set of 
configuration files. Resources specifications in later files override those in earlier 
files. Files are read in the following order: 

1 The apphcation defaults file. For example, 
$HP64000/lib/Xl l/app-defaults/HP64_Debug in HP-UX or 
/usr/openwin/lib/Xll/app-defaults/HP64_Debug in SunOS. 

2 The $XAPPLRESDIR/HP64_Debug file. (The XAPPLRESDIR environment 
variable defines a directory containing system- wide custom application 
defaults.) 

3 The server' s RES OURCE_MAN ACER property. (The xrdb command loads 
user-defined resource specifications into the RESOURCE_MANAGER 
property.) 

If no RESOURCE_MANAGER property exists, user defined resource settings 
are read from the $HOME/.Xdefaults file. 

4 The file named by the XENVIRONMENT environment variable. 

If the XENVIRONMENT variable is not set, the $H0ME/.Xdefaults-/20.vf file 
(typically containing resource specifications for a specific remote host) is read. 
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5 Resource specifications included in the command line with the -xrm option. 

6 System scheme files in directory /usr/hp64000/lib/Xl l/HP64_schemes. 

7 System-wide custom scheme files located in directory 
$XAPPLRESDIR/HP64_schemes. 

8 User-defined scheme files located in directory $HOME/.HP64_schemes (note 
the dot in the directory name). 

Scheme files group resource specifications for different displays, computing 
environments, and languages. 

The HP64_Debug application defaults file is re-created each time debugger's 
graphical interface software is installed or updated. You can use the UNIX diff 
command to check for differences between the new HP64_Debug application 
defaults file and the old application defaults file that is saved as 
/usr/hp64000/lib/Xll/HP64_schemes/old/HP64_Debug. 

Refer to the "X Resources and the Graphical Interface" chapter for more detailed 
information about X resources. 
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To modify the debugger's graphical interface 
resources 



You can customize the appearance of an X Windows application by modifying its 
X resources. The following tables describe some of the commonly modified 
application resources. 



Application Resources for Schemes 


Resource 


Values 


Description 


HP64 Oebu? nlatfoririLScheme 


HP-UX 

SunOS 

(custom) 


Names the subdirectory for platform 
specific schemes. This resource should be 
set to the platform on which the X server is 
running (and displaying the debugger's 
graphical interface) if it is different than the 
platform where the appUcation is running. 


HP64_Debug.colorScheme 


BW 

Color 
(custom) 


Names the color scheme file. 


HP64_Debug.sizeScheme 


Small 
Large 
(custom) 


Names the size scheme file which defines 
the fonts and the spacing used. 


HP64_Debug.labelScheme 


Label 

$LANG 

(custom) 


Names to use for labels and button text. 
The default uses the $LANG environment 
variable if it is set and if a scheme file 
named Debug.$LANG exists in one of the 
directories searched for scheme files; 
otherwise, the default is Label. 


HP64_Debug.inputScheme 


Input 
(custom) 


Specifies mouse and keyboard operation. 
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Commonly Modified Application Resources 


Resource 


Values 


Description 


HP64_Debug.enableCmdline 


True 
False 


Specifies whether the command line area is 
displayed when you initially enter the 
debugger's graphical interface. 


*editFile 


(example) vi 

%s 


Specifies the command used to edit files. 


*editFileLine 


(example) vi 
+%d %s 


Specifies the command used to edit a file at 
a certain line number. 


*<class> *actionKeysSub.keyDers 


(paired list 
of strings) 


Speciries the text that should appear on the 
action key pushbuttons and the commands 
that should be executed in the command 
line area when the action key is pushed. 
Refer to the "To set up custom action keys" 
section for more information. 


*<c/a5'5'> *dirSelectSub .entries 


(list of 
strings) 


Specifies the initial values that are placed in 
the File^Context^Directory pop-up 
recall buffer. Refer to the "To set initial 
recall buffer values" section for more 
information. 


* <c/aii> *recallEntrySub.entries 


(Ust of 
strings) 


Specifies the initial values that are placed in 
the entry buffer (labeled "():")■ Refer to the 
"To set initial recall buffer values" section 
for more iirformation. 



<class> is "m68340" or "m6833x". 
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The following steps show you how to modify the debugger's graphical interface's 
X resources. 

1 Copy part or all of the HP64_Debug apphcation defaults file to a temporary file. 
If you are using an HP-UX computer, type: 

cp $HP64000/lib/Xll/app-defaults/HP64_Debug HP 64_Debug . tmp 

If you are using SunOS, type: 

cp /usr/openwin/lib/Xll/app-def aults/HP64_Debug HP 64_Debug . tmp 

2 Make the temporary file writable: 

chmod +w HP64_Debug . tmp 

3 Modify the temporary file. 

Modify the resource that defines the behavior or appearance that you wish to 
change. 

For example, to change the number of lines in the main display area to 36, search 
for the string "HP64_Debug.lines". You should see lines similar to the following. 



! The lines and columns set the vertical and horizontal dimensions of the 

! main display area in characters, respectively. Minimum values are 18 lines 

! and 80 columns. These minimums are silently enforced. 

! Note: The application cannot be resized by using the window manager. 

!HP64_Debug.lines: 24 
! HP64_Debug. columns : 85 

Edit the line containing "HP64_Debug.lines" so that it is uncommented and is set 
to the new value: 



! The lines and columns set the vertical and horizontal dimensions of the 

! main display area in characters, respectively. Minimum values are 18 lines 

! and 80 columns. These minimums are silently enforced. 

! Note: The application cannot be resized by using the window manager. 

HP64_Debug. lines : 36 
! HP64_Debug. columns : 85 

If you wish, you may delete any lines which you will not be modifying; any 
resources you delete will use the default values. 
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Save your changes and exit the editor. 

4 If the RESOURCE_MANAGER property exists (as is the case with HP VUE — if 
you're not sure, you can check by entering the xrdb -query command), use the 
xrdb command to add the resources to the RESOURCE_MANAGER property. For 
example: 

xrdb -merge -nocpp HP64_Debug . tmp 

5 Save the changes where they can be found by the debugger. 

One way to do this is to append the temporary tile to your $HOME/.Xdefaults file. 
For example: 

cat HP64_Debug.tmp >> $HOME/ . Xdef aults 

You can also save the changes in a scheme file (see "To use customized scheme 
files"). 

6 Remove the temporary file. 

7 Start or restart the debugger's graphical interface. 
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To use customized scheme files 

Scheme files are used to set platform specitic resources that deal with color, fonts 
and sizes, mouse and keyboard operation, and labels and titles. You can create and 
use customized scheme files by following these steps. 

1 Create the $HOME/.HP64_schemes/<platform> directory. 

For example; 

mkdir $HOME/ . HP64_scheines 
mkdir $HOME/ . HP64_schemes/HP-UX 

2 Copy the scheme file to be modified to the $HOME/.HP64_schemes/<platform> 
directory. 

Label scheme files are not platform specific; therefore, they should be placed in the 
$HOME/.HP64_schemes directory. All other scheme files should be placed in the 
$HOME/.HP64_schemes/<platform> directory. 

For example: 

cp /usr/hp64 000/lib/Xll /HP 64_schemes/HP-UX/Debug. Color 
$HOME/ .HP64_schemes/HP-UX/Debug.MyColor 

Note that if your custom scheme file has the same name as the default scheme fUe, 
the load order requires resources in the custom file to exphcitly override resources 
in the default fUe. 

3 Modify the $HOME/.HP64_schemes/<platform>/Debug.<scheme> fUe. 
For example, you could modify the 

"$HOME/.HP64_schemes/HP-UX/Debug.MyColor" file to change the defined 
foreground and background colors. Also, since the scheme file name is different 
than the default, you could comment out various resource settings to cause general 
foreground and background color definitions to apply to the debugger's graphical 
interface. At least one resource must be defined in your color scheme file for it to 
be recognized. 
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4 If your custom scheme file has a different name than the default, modify the 
scheme resource definitions. 

The debugger's graphical interface appUcation defaults file contains resources that 
specify which scheme files are used. If your custom scheme files are named 
differently than the default scheme files, you must modify these resource settings 
so that your customized scheme files are used instead of the default scheme files. 

For example, to use the "$HOME/.HP64_schemes/HP-UX/Debug.MyColor" color 
scheme file you would set the "HP64_Debug.colorScheme" resource to "MyColor": 

HP64_Debug. colorScheme : MyColor 
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To set up custom action keys 



• Modify the "actionKeysSub.keyDefs" resource. 

To modify this resource, follow the procedure in "To modify the debugger's 
graphical interface resources." 

The "actionKeysSub.keyDefs" resource defines a list of paired strings. The first 
string defines the text that should appear on the action key pushbutton. The second 
string defines the command that should be sent to the command Une area and 
executed when the action key is pushed. 

A pair of parentheses (with no spaces, that is "()") can be used in the command 
definition to indicate that text from the entry buffer should replace the parentheses 
when the command is executed. 

Action keys that use the entry buffer should always include the entry buffer 
symbol, "( )", in the action key label as a visual cue to remind you to place 
information in the entry buffer before clicking the action key. 

Shell commands can be executed by using the Debugger Host_Shell command. 

Also, command files can be executed by using the File Command command. 

Finally, an empty action ("") means to repeat the previous operation, whether it 
came from a pull-down, a dialog, a pop-up, or another action key. 



Example 



To set up custom action keys, modify the "debug*actionKeysSub.keyDefs" 
resource: 



*<class>* act ionKeysSub . keyDef s : \ 
"Make" "D H make 

"Disp Src 0 " "P C S 0 

"Run Until ( ) " "P R U () 

"Step" "P S" 



\ 



I" \ 
P D 0 



\ 



See Also 



"To modify debugger's graphical interface resources" in this chapter. 
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To set initial recaii buffer vaiues 

• Modify the "entries" resource for the particular recall buffer. 



Some of the resources for the pop-up recall buffers are Usted in the following table: 



Pop-up Recall Buffer Resources 


Recall Pop-up 


Resources 


Entry Buffer (): 


*recaUEntrySub. entries 


File^Context^Directory ... 


*dirSelectSub.entries 


Modify— ^Register; Recall Value 


*modRegDB*recallSub.entries 


Command Line command recall 


*recallCmdSub .entries 


Macro Operations dialog box; Recall 
Value 


*macroDB_popup*recallSub.entries 



Other X resources for the recall buffers are described in the supplied application 
defaults file. 



The window manager resource "*transientDecoration" controls the borders around 
dialog box windows. The most natural setting for this resource is "title." 



Example To set the initial values for the directory selection dialog box, modify the 

"debug*dirSelectSub.entries" resource: 

* <cia5s>*dirSelectSub . entries : \ 
"$HOME" \ 
\ 

"/users/projectl" \ 
"/users/pro ject2/code" 

Refer to the previous "To modify the debugger's graphical interface resources" 
section in this chapter for more detailed information on modifying resources. 
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9 




Configuring the HP 64751 Emulator 

How to configure the HP 6475 1 68340 emulator for your target system. 
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Each target system ditTers in the way it uses the processor, memory, and memory 
mapped I/O devices. During system development, your needs for emulator 
resources may change as your target system design matures. You can allocate 
emulator resources by configuring the emulator. 

There are three ways to configure the emulator: 

• Load a configuration file into the emulator. 

• Change the configuration using the Emulator Configuration dialog box. 

• Change the configuration using the Debugger Execution Environment 
Modify_Config command from the command Une. 

The Emulation Configuration dialog box is available both in the debugger/emulator 
graphical interface and in the emulator/analyzer graphical interface. 

Some of the configuration items mentioned in this chapter may not be available for 
all emulators. 

The simulated I/O feature and configuration questions are described in the 
Simulated I/O User's Guide. 

The interactive measurement configuration questions are described in the 
emulator/analyzer manual. 

What must be configured 

For any target system, you must configure: 

Memory. Because the emulator can use target system memory or emulation 
memory (or both), it is necessary to map ranges of memory so that the emulator 
knows where to direct its accesses. 

You can synchronize emulation memory accesses to the target system in order to 
more closely imitate target system memory. For example, if emulation memory 
replaces slower target system memory that requires wait states, synchronizing 
emulation memory to the target system causes wait states to be inserted on 
emulation memory accesses as they would be on target system memory accesses. 

Refer to the "Mapping Memory" section later in this chapter. 

Clock. Generally, you should use the target system clock when plugging the 
emulator into a target system. 
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Real-time circuitry. Is there circuitry in the target system that requires programs 
to run in real-time? Some emulator commands cause temporary breaks to the 
monitor state, typically to access microprocessor register values, single-port 
emulation memory, or target system memory. If the target system requires that 
programs run in real-time, you must restrict the emulator to real-time runs. 

Interrupts. Should the emulator respond to target system interrupts when running 
in the monitor program? If so, you must use a foreground monitor program since 
target system interrupts are always ignored during background operation (refer to 
the "Selecting the Emulation Monitor" section later in this chapter). If it's not 
important that the emulator respond to target system interrupts when running in the 
monitor, you can use the background monitor. 



Using the Configuration Interface 

This secton shows you how to modify, store, and load configurations using the 
emulator configuration interface. 

This chapter describes emulator configuration in general terms. For information 
about your emulator's specific configuration questions, refer to your emulator 

User's Guide. 
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To start the Emulator Configuration diaiog box 

• Select Modify^Emulator Config... in either the debugger/emulator or 
emulator/analyzer graphical interface. 

The Emulator Configuration main menu and an Emultor Configuration window are 
displayed. The Emulator Configuration dialog box may be left running while you 
are using the debugger. 



Examples 



The Emulator Configuration main menu is shown below. 



Clicking on one of thesa 
hues selects a particular 
coirfiguration section. 



Clicking this button 
presents the questions 
for the selected 
configuration section. 




Emulator Configuration: Main Menu 



■ Emulator Configuration Sections - 
♦ General Items 
O Reconfigure Internal Registers 
O Monitor Type 
O Memory Map 
O Emulator Pod Settings 
O Debug/Trace Options 
O Simulated 10 



p Analyzer Configuration Sections 

O Interactive Measurement Specification 



Modify 




Apply to 




Exit 




Help 


Section 




Emulator 




Window 




Topic 



Clicking this button ti 
the emulator to begin 
using the new 
configuration. 



fe^lf^licking this bu^oi 



Clicking this button 
exits the Emulator 
Configuration dialog. 



Clicking this button 
presents general 
configuration 
instructions. 
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To modify a configuration section 

1 Start the emulator Emulator Configuration dialog box. 

2 Click on a section name in the Emulator Configuration main menu, and cUck the 
"Modify Section" pushbutton. 

3 Use the command Une in the Emulator Configuration window to answer the 
configuration questions. 

Each configuration section presents a window similar to the following. 



The menu bar. 



Configuration help 
text display area. 



/ 
\ 



Emulator status and 
error message line. \ 

Command line text 
entry area. 



lEmulator^Configur^^ 



File Display 




select Internal or external emulation clock 



Hhen the internal clock has been selected, the emulator 

lui 1 1 operate using an internal 32.768 Khz crystal. 

The target system MUST drive MODCLK high (or allow 

a pullup resistor in the emulator to pull it high) during 

reset to enable the 68349 VCO. 

Nhen the external clock has been selected, the emulator 
ujill use the crystal or TIL oscillator in the target system. 
MODCLK should be driven appropriately. 



STATUS: CDnfiguring H6834e 



I Micro-processor clock source? internal 



Help 



Pushbutton SOfflre^* .| |internalj|external|P 



RECHLL 



Command: 



RetumJIgpeal^^^^^^ Cursor: [Backup 



Forward 



Clear to end 



Clear 



Help 



Command control 
and cursor control, 
pushbuttons. 
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To answer a configuration question, click the softkey pushbutton that has your 
answer. Or, click on the "Return" command pushbutton to accept the answer that is 
shown. 

When you answer a configuration question, you are normally presented with the 
next question in the section; however, there are some cases when a carriage return 
is required, and you can supply it by clicking the Return command pushbutton or 
by pressing the <Return> key. 

At the last question of a configuration section, you are asked if you wish to return 
to the main menu. You can click the "next_sec" softkey pushbutton to access the 
questions in the next configuration section. 

To recall a configuration question, cUck the RECALL softkey pushbutton. If you 
do this at the starting question of a configuration section, you are asked if you want 
to return to the main menu. 

In order for the emulator to recognize any configuration changes, the configuration 
must be applied to the emulator. 



To store a configuration 

• When answering the configuration questions, choose File^Store... from the 
pull-down menu, and use the File Selection dialog box to name the coirfiguration 
file. 

• When finished setting a configuration, click on the Exit Window button. A dialog 
box will ask whether you want to store the configuration. 

The file to which the configuration is stored becomes the current configuration file. 
The emulator only recognizes configuration changes when they are stored or 
loaded. 

When modifying a configuration, you can choose to store your answers at any time. 
This is useful for quickly verifying the effect a coirfiguration change has on the 
emulator. 
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Configuration information is saved in two tiles with extensions of ".EA" and ".EB". 
The file with the ".EA" extension is the "source" copy of the file, and the file with 
the ".EB" extension is the "binary" or loadable copy of the file. 

For more information on how to use dialog boxes, refer to the "To use dialog 
boxes" description in the "Entering Commands" chapter. 



To examine the emulator configuration 

1 Select Modify^Emulator Config... to display the Emulator Configuration dialog 
box. 

2 CUck on the configuration section you wish to examine. 

3 CUck on the Return button or press <Retum> on your keyboard to page through 
the configuration questions without changing their values. 

4 At the end of the configuration section, click on yes to return to the Emulator 
Configuration dialog box (main menu). 

5 Click on Exit Window. 

This procedure allows you to examine the emulator configuration without changing 
it. 

If you accidentally change one of the configuration items, don't worry. As long as 
you do not click on Apply to Emulator, any changes you make will not be saved. 
Just click on Yes when the debugger asks "Your changes will be lost — Exit 
configuration?" 
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To change the configuration directory context 

• When answering the configuration questions, choose File^Directory... from the 
pull-down menu, and use the Directory Selection dialog box to specify the new 
directory. 

The directory context specifies the directory to which configuration files are stored 
and from which they are loaded. 

The Emulator Configuration dialog box directory context is separate from the 
debugger interface directory context. Changing one does not affect the other. 



To display the configuration context 

• When answering the configuration questions, choose Display^Context... from the 
pull-down menu. 

The current directory context and the current configuration files are displayed in a 
window. Click the Done pushbutton when you wish to close the window. 
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To access configuration help information 

• When answering the configuration questions, choose Help^General Topic... 
from the pull-down menu. 

• From the Emulator Coirfiguration dialog box main menu, click on the "Help Topic" 
button. 



To exit the Emulator Configuration dialog box 

• When answering the configuration questions, choose File— >Exit... from the 
pull-down menu (or type <CTRL>x), and click Yes in the confirmation dialog box. 

• From the Emulator Coirfiguration dialog box main menu, click the Exit Window 
button, and click Yes in the coirfirmation dialog box. 

Any modifications made to the configuration which haven't been stored are lost. 
Choosing No from the confirmation dialog box cancels the exit and keeps the 
emulator Emulator Configuration dialog box running. 
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To load a configuration fiie 

• Use the -C command line option when starting the debugger. 
Or: 

• Use a default configuration file. 
Or: 

• Select File^Load^Emulator Config. 

Or: 

• Using the command line, enter 

Debugger Execution Environment Load_Config 

The emulation configuration file contains configuration information for the 
emulator. The debugger/emulator accepts files generated by the emulation software 
or by an editor. The debugger uses the . EA suffixed file (ASCII format) to load 
emulator configurations. 

If you do not specify a configuration file (no -C option is given) and the emulator is 
locked at startup, the configuration saved when you left the emulator locked is 
used. No default configuration is loaded. 

If you do not specify the -C option and the emulator is not locked, the debugger 
searches for a default configuration file in the following sequence: 

1 configuration file default.EA in the current directory. 

2 configuration file default.EA in the $HOME directory. 

3 configuration file /usr/hp64000/inst/emul/64751A/userconfig.EA 

4 configuration fi[e/usr/hp64000/inst/emul/64751A/default.EA 

provided with the HP 64751 68340 emulator/analyzer user interface software. 
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Note Default configuration tiles are also supplied with the HP B 1462 68332 C compiler. 

You should copy the appropriate default configuration file for your memory 
configuration into your directory and name it default.EA. These files are located in 
directories: 

/usr/hp64000/env/hp64751 

The file userconfig.EA is not supplied with the debugger. This tile name refers to a 
configuration file that you may create and put in directory 

/usr/hp64000/inst/emul/64751A 

where <emul_dir> is: 

64751 A for the HP 64751 emulator 



Examples The following examples show a few ways to load a configuration tile: 

db68k -e test -C srwcfg.EA 

Run the debugger using emulator "test" and configuration file 
"srwcfg.EA" 

db68k -e m68340 

Run the debugger using emulator "m68340" and use the default 
configuration file named "default.EA" in the current working 

directory. 

If "default EA " does not exist in the current directory, the 
debugger searches for a default configuration file in the sequence 
described previously in this chapter, in the section titled "To 
Configure the Emulator". 

Debugger Execution Environment Load_Config "mycnfig" 

Load the emulation configuration file "mycnfig.EA" (from within 
the debugger). 
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To create or modify a configuration file 

• Use the Emulator Configuration dialog box to set up the configuration, then save 
the coirfiguration using File^Store^Emul Config. 

Or: 

• Change the configuration using the Debugger Execution Environment 
Modify_Config command from the command line. 

Or: 

• Edit a configuration file using a text editor. 

If you use a text editor to create a configuration file, be use to give the file a name 
with the file extension . EA. The . EA file extension tells the debugger that the file 
is an ASCn configuration file. 

If an error occurs when loading a configuration 
file 

• Load a different configuration file. 
Or: 

1 Exit the debugger. 

2 Modify the configuration file using a text editor. 

3 Retum to the debugger 
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Caution If you reload a configuration using the Debugger Execution 

Environment Load_Configcommand, the contents of memory will be 
changed. Even if the new configuration memory map is identical to the old 

memory map, you must reload the contents of memory. 



See also 

The Softkey Interface User's Guide for your emulator 
68332 C Cross Compiler Reference 
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Modifying tlie General Configuration Items 

In order to modify the general configuration items, you must first start the 
configuration interface and access the "General Items" configuration section (refer 
to the previous "Using the Configuration Interface" section). 

This section shows you how to: 

• Select the emulator' s clock source. 

• Enable/disable entry into the monitor after configuration. 

• Restrict to real-time runs. 

• Turn OFF the restriction to real-time runs. 
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To select the emulator's clock source 

• Answer "internal" or "external" to the "Micro-processor clock source?" question. 

When you answer "internal", the emulator will use the internal 32.768 KHz crystal. 
The target system MUST drive MODCLK high (or allow a pullup resistor in the 
emulator to pull it high) during reset to enable the microprocessor's 
voltage-controlled oscillator (VCO). 

When you answer "external", the emulator will use the crystal or TTL oscillator in 
the target system. MODCLK should be driven appropriately. 

Generally, you should select the extemal clock option when using the emulator 
in-circuit to synchronize the emulator with your target system. 

Your target system clock must conform to the specifications for the 
microprocessor. The maximum clock speed with the HP 64751 emulator is 
16 MHz. 

Note that changing the clock source drives the emulator into the reset state. The 
emulator may later break into the monitor depending on how the "Enter monitor 
after configuration?" question is answered. 



To enable/disable entry into the monitor after 
configuration 

• Answer "yes" or "no" to the "Enter monitor after configuration?". 

This question allows you to select whether the emulator will be running in the 
monitor or held in the reset state on completion of the emulator configuration. 

The answer to this configuration question is important in some situations. For 
example, when you select the external clock and the target system is turned off, do 
not select reset to monitor. Otherwise, configuration will fail. When you select an 
external clock source, this question becomes "Enter monitor after configuration 
(using extemal clock)?" and the default answer becomes "no". 
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To restrict to real-time runs 

• Answer "yes" to the "Restrict to real-time runs?" question. 

While running programs, temporary breaks to the monitor state are not allowed. 
The emulator refuses the following commands: 

• Display or modify registers. 

• Display, modify, copy, load, store, or breakpoint commands that access 
single- port emulation memory or target system memory. 

The emulator contains one 4 Kbyte block of dual-port emulation memory 
which can be accessed while runs are restricted to real-time. This block of 
dual-port emulation memory is reserved for foreground monitor programs 
when they are used. 

• Synchronize SIM registers. 

If you want to enter one of these commands, you must first make an expUcit break 
into the monitor using the break command. 



CAUTION Target system damage could occur! If your target system circuitry is dependent 

on constant execution of program code, be aware that the following commands stiU 
cause breaks from running programs even when you have restricted the emulator to 
real-time runs: 

• reset 

• run 

• break 

• step 

Use caution in executing these commands. 
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To turn OFF the restriction to reai-time runs 

• Answer "no" to the "Restrict to real-time runs?" question. 

Temporary breaks to the monitor while running programs are allowed, and the 
emulator accepts commands normally. 
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Reconfiguring tlie Emuiator Configuration 
Registers 

In order to modify the general configuration items, you must first start the 
configuration interface and access the "Reconfigure Internal Registers" 
configuration section (refer to the previous "Using the Configuration Interface" 
section). 

This section shows you how to: 

• Define values for the 68340 emulator configuration registers. 



To define values for the 68340 emulator 
configuration registers 

• Answer the "Initial value of the configuration copy of <CF_SIM_REGISTER>" 
questions. 

These questions allow you to specify the initial values of the following CF_SIM 
registers. 

CF_MBAR 

CF_SIM_MCR 

CF_PPARA1 

CF_PPARA2 

CF_CSOADDR 

CF_CSOMASK 

CF_CS1ADDR 

CF_CS1MASK 

CF_CS2ADDR 

CF_CS2MASK 

CF_CS3ADDR 

CF_CS3MASK 
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Selecting the Emulation Monitor 

This section applies only to the HP 6475 1 emulator. 
This section shows you how to: 

• Select the background monitor (implemented with the 68340 Background 
Debug Mode (BDM)). 

• Select the foreground monitor program. 

• Use a custom foreground monitor program. 

When you power up the emulator, or when you initialize it, the background 
monitor is selected. You can also configure the emulator to use a foreground 
monitor. Before the background and foreground monitors are described, you 
should understand the foreground and background emulator modes as well as the 
function of the emulation monitor. 

Background 

Background is the emulator mode in which emulation processor execution is 
suspended. 

Foreground 

Foreground is the mode in which the emulator executes as if it were a real 
microprocessor. The emulator is in foreground when it is nmning user programs or 
running in a foreground monitor. 

Function of the Monitor 

The monitor is the interface between the emulation system controller (which 
accepts and executes emulation commands) and the target system. The monitor 
uses the emulation microprocessor because that's the only way to access registers, 
single-port emulation memory, and target system memory. 

When the emulation system controller recognizes that a command requires the 
monitor, it writes a command code to a communications area and "breaks" 
emulator execution into the monitor. The monitor reads this command (and any 
associated parameters), makes the appropriate accesses, places the values in the 
communication area, and returns emulator execution to its previous state. 
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Background Monitor 

When a background monitor is selected, the Background Debug Mode (BDM) of 
the 68340 processor is used. The BKPT Une is asserted to enter the monitor. 

Foreground Monitor 

The foreground monitor is an assembly language program that is executed by the 
68340 emulation microprocessor in its normal operating mode. 

When a foreground monitor is selected, the foreground monitor or downloaded 
custom monitor is loaded into dual-ported emulation memory and consumes a 
4 Kbyte block of the 68340' s address range. 

The foreground monitor program is included with the interface software as 
/usr/hp64000/monitor/fmon68340.s. It can be assembled with the HP AxLS 
68000/10/20 Assembler/Linker/Librarian or with the Microtec Research 68000 
assembler and linker. 

You may customize the foreground monitor if necessary; however, you must 
maintain the basic communications protocol between the monitor and the 
emulation system controller. Comments in the monitor program source file detail 
sections that caimot be changed. 



Comparison of Background and Foreground Monitor Programs 


Monitor Program Characteristic 


Background 


Foreground 


Takes up processor memory space 


No 


Yes, 4 Kbytes 


Allows the emulator to respond to target system 
interrupts during monitor execution 


No 


Yes 


Can be customized 


No 


Yes 


Resident in emulator firmware 


68340 emulation 
processor's BDM 


Yes, (custom monitor 
must be assembled, 
linked, and loaded) 
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To select the background monitor 

1 Access the configuration questions. 

2 Answer "yes" to the "Modify memory corrfiguration?" question. 

3 Answer "background" to the "Monitor type?" question. 

4 Answer "yes" to the "Reset map (change of monitor type requires map reset)?" 
question. 

5 Re-map memory (see the following section on "Mapping Memory"). 

When a background monitor is selected, the Background Debug Mode (BDM) of 
the 68340 processor is used. The BKPT line is asserted to enter the monitor. 

During background monitor operation, there will be no bus cycle activity except for 
memory reads and writes that result from memory display or modify commands. 

Changing the monitor configuration resets the memory map, so you must re-map 
memory. 



To select the foreground monitor program 

1 Access the configuration questions. 

2 Answer "yes" to the "Modify memory configuration?" question. 

3 Answer "foreground" to the "Monitor type?" question. 

4 Answer "yes" to the "Reset map (change of monitor type requires map reset)?" 
question. 
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5 Enter 0 through 7 in response to the "Interrupt priority level for default foreground 
monitor?" question. 

6 Enter the base address of the monitor in response to the "Monitor's base address?" 
question. 

7 Answer the "Enable /DSACK interlocking on monitor addresses?" question. 

8 Re-map memory (see the following section on "Mapping Memory"). 

9 Answer "yes" to the "Modify emulator pod configuration?" question. 

10 Answer the "Reset value for Supervisor Stack Pointer?" question. 

11 Answer the "Reset value for Program Counter?" question. 

12 Save the configuration changes. 

13 Modify the TRACE exception vector to point to the TRACE_ENTRY symbol in 
the monitor program so that you can step through the user program. 

Selecting the Foreground Monitor 

Answering "foreground" to the "Monitor type?" question causes the current 
memory map to be deleted, and a new map term is added for the monitor program. 
The starting address of the monitor block is set by answering the "Monitor's base 
address?" question, and your response to the "Enable /DSACK interlocking on 
monitor addresses?" question determines whether the dsi (/DSACK interlock) 
memory attribute is added. 

When you select a foreground monitor, the emulator automatically loads the 
default program, resident in emulator firmware, into dual-ported emulation 
memory. The foreground monitor is reloaded every time the emulator breaks into 
the monitor state from the reset state. 

Unhke the background monitor, the foreground monitor runs within the same 
address space as the target program consuming a 4 Kbyte block of the 68340' s 
address range. The foreground monitor can run with target interrupts enabled (see 
"Selecting the Interrupt Priority Level" below). 
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The emulator breaks into the foreground monitor by using the emulation 
processor' s background debug mode (BDM) except for single-stepping, which uses 
the trace exception. The time spent in BDM is approximately 350 microseconds. 
An exception stack frame of 7 to 13 words will be temporarily pushed onto the 
user's master and/or interrupt stack(s) during monitor entry. 

Selecting the Interrupt Priority Level 

The default foreground monitor can be configured to run at a lowered interrupt 
priority level to allow critical target system interrupts to be processed during 
monitor execution. 

At the point it is safe to lower the interrupt priority level, the foreground monitor 
wiU set the interrupt priority mask to the value specified or the interrupt level that 
was in effect before monitor entry, whichever is greater. 

During background monitor operation, all target system interrupts, including level 
7 non-maskable interrupts, are blocked. 

Modifying this configuration item will reset the processor. 
Selecting the Monitor's Base Address 

Your response to the "Monitor' s base address?" question defines the starting 
address of the 4 Kbyte block of dual-ported emulation memory. This block of 
memory is reserved for the foreground monitor. The address must reside on a 
4 Kbyte boundary (in other words, an address ending in OOOH) and must be 
specified in hexadecimal. Also, the foreground monitor's base address must have 
no function code specified. 

The current memory map will be deleted, and a new map term is added for the 
monitor. 

Specifying Target Synchronization 

If you wish to synchronize monitor cycles to the target system (that is, interlock the 
emulation and target system /DSACK on accesses to the monitor memory block), 
answer "yes" to the "Enable /DSACK interlocking on monitor addresses?" 
question; otherwise, answer "no". 

When interlocking is enabled, cycle termination of accesses to foreground monitor 
memory will not occur until the target system provides a /DSACK. If the monitor 
is placed in an address range for which the target system does not generate a 
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/DSACK, the emulator will be unable to break into the monitor and a "CPU in wait 
state" status will result. 

When interlocking is disabled, accesses to foreground monitor memory will be 
terminated by a /DSACK signal generated by the emulator. Any cycle termination 
signals generated by the target system during monitor memory accesses, including 
/BERR, will be ignored. 

Modifying this configuration item will reset the processor and controls whether the 
dsi (/DSACK Interlock) memory attribute is used in the foreground monitor 
memory map term. 

Re-Mapping Memory 

When you configure the emulator for a foreground monitor program, the memory 
map is reset, and a 4 Kbyte block of emulation memory is automatically mapped 
for the monitor program. You must re-map other memory ranges before loading 
user programs. 

Modifying tlie TRACE Exception Vector 

In order for single stepping to operate with the foreground monitor, the trace vector 
in the target system's exception table (VBR plus 24H) must point to the 
TRACE_ENTRY address in the monitor. This address is equal to the monitor's 
base address plus 800H in the default foreground monitor. 



To use a custom foreground monitor program 

1 Edit the monitor program source file to define its base address. 

2 Assemble and link the monitor program. 

3 Access the configuration questions. 

4 Answer "yes" to the "Modify memory configuration?" question. 

5 Answer "user_foreground" to the "Monitor type?" question. 
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6 Answer "yes" to the "Reset map (change of monitor type requires map reset)?" 
question. 

7 Enter the name of the monitor program absolute file in response to the "Monitor 
filename?" question. 

8 Enter the base address of the monitor in response to the "Monitor's base address?" 
question. 

9 Answer the "Enable /DSACK interlocking on monitor addresses?" question. 

10 Re-map memory (see the following section on "Mapping Memory"). 

11 Answer "yes" to the "Modify emulator pod configuration?" question. 

12 Answer the "Reset value for Supervisor Stack Pointer?" question. 

13 Answer the "Reset value for Program Counter?" question. 

14 Save the configuration changes. 

15 Modify the TRACE exception vector to point to the TRACE_ENTRY symbol in 
the monitor program so that you can step through the user program. 

Using a custom foreground monitor program is the same as selecting the default 
foreground monitor, except that the customized monitor program must be 
assembled, linked, and loaded into emulation memory. Also, the "Interrupt priority 
level for default foreground monitor?" question is not asked because you can 
specify the interrupt priority level in the program. 

A custom foreground monitor must be assembled and linked starting at the 4 Kbyte 
boundary specified as the monitor's base address. An ORG statement in the 
foreground monitor source file defines the base address. Refer to the foreground 
monitor source provided with the emulator for more information. 

The custom foreground monitor is saved in the emulator (until the monitor type is 
changed) and reloaded every time the emulator breaks into the monitor state from 
the reset state. 
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Examples The following examples of how to set up and use a foreground monitor program 

assume the HP 64870 or HP B1464 68000/08/10/20/302 
Assembler/Linker/Librarian is installed on the host computer. 

To copy the foreground monitor program source file: 

$ cp /usr/hp64000/monitor/finon68340 . s . <RETURN> 

To edit the monitor program source: 

$ chmod 644 fmon68340.s <RETURN> 
$ vi fmon68340.s <RETURN> 

The monitor will be loaded at 20000H, so the modify ORG statement near the top 
of the file to look hke this: 

ORG 020000H * START MONITOR ON 4K BOUNDARY 

Notice that the ORG statement is indented from the left margin; if it is not 
indented, the assembler will interpret the ORG as a label and will generate an error 
when processing the address portion of the statement. 

To assemble and link the monitor program, enter the following commands 
(which assume that/usr/hp64000/bin is defined in the PATH enviroimient 
variable): 

$ as68k -L fmon68340.s > fmon68340 . lis <RETURN> 

$ ld68k -c fmon68340.k -L > fmon68340 .map <RETURN> 

Where the "fmon68340.k" linker command file is: 

name fmon6834 0 
load fmon68340.o 
end 

To configure the emulator to use a foreground monitor program, access the 
configuration questions, and answer the questions as shown below. 

Modify memory configuration? yes 
Monitor type? user_foreground 

Reset map (change of monitor type requires map reset)? yes 
Monitor file name? fmon68340 
Monitor's base address? 20000h 

Re-map memory for the demo program by entering the following mapper 
commands: 
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0 thru 6fffh emulation rom <RETURN> 
7000h thru 16fffh emulation ram <RETURN> 
end <RETURN> 

Modify emulator pod configuration? yes 
Reset value for Supervisor Stack Pointer? 13000h 
Reset value for Program Counter? 400h 
Configuration file name? fmoncfg 

To load the demo program absolute file, select File— >Load— ^Executable. 

To modify the TRACE exception vector to point to the TRACE_ENTRY label 
in the monitor program (so that the emulator can single-step), modify the 
memory location at 24h to 20800h. 



Mapping Memory 

Because the emulator can use target system memory or emulation memory (or 
both), it is necessary to map ranges of memory so that the emulator knows where to 
direct its accesses. 

Up to 7 ranges of memory can be mapped, and the resolution of mapped ranges is 
256 bytes bytes (that is, the memory ranges must begin on 256 byte boundaries and 
must be at least 256 bytes in length). 

The emulator contains 4 Kbytes of dual-port emulation memory and provides two 
slots for additional emulation memory modules. 

Emulation memory supports processor clock speeds up to 16.78 MHz with no 
wait-states. 
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The amount of emulation memory that can be mapped depends on the number, and 
size, of memory modules installed on the emulator board. 



Amount of Emulation Memory 




Number of 256 Kbyte memory modules 


0 


1 


2 


Number of 
1 Mbyte 
memory 
modules 


0 


4 Kbytes 


260 Kbytes 


516 Kbytes 


1 


1028 Kbytes 


1284 Kbytes 




2 


2052 Kbytes 







Emulation memory is made available to the mapper in blocks. When you map an 
address range to emulation memory, at least one block is assigned to the range. 
When a block of emulation memory is assigned to a range, it is no longer available, 
even though part of the block may be unused. 



Emulation memory in bank 0 of the emulator probe is divided into 4 equal blocks, 
and memory in bank 1 is divided into 2 equal blocks. The 4 Kbyte block of 
dual-port emulation memory is 1 block. 



Blocks of Emulation Memory Available to Mapper 
(in addition to the 1 block of dual-port memory, 4 Kbytes long) 


Emulation Memory Module 


BankO 


Bankl 


HP64171A 
256 Kbytes 


4 blocks, 
64 Kbytes each 


2 blocks, 
128 Kbytes each 


HP64171B 
1 Mbyte 


4 blocks, 
256 Kbytes each 


2 blocks, 
512 Kbytes each 
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When you map ranges of emulation memory, blocks are allocated so as to leave the 
greatest amount of emulation memory available. For example, if you map the range 
0 through OFFH as emulation memory, the 4 Kbyte block of dual-port memory is 
used if possible; if that block has already been used, the next smallest available 
block is used. 

You should map all memory ranges used by your programs before loading 
programs into memory. 

Using Emulation Memory to Substitute for 8-Bit Memory 

Emulation memory is 16-bit wide memory. However, you can use emulation 
memory to substitu te for 8-bi t memory by using one of the chip selects and 
generating internal DSACKx signals for an 8-bit port. You must place the 
appropriate values into the emulator configuration (CF_SIM) versions of the chip 
select address and mask registers so that emulation memory is accessed correctly. 

Using Chip Selects to Access Emulation Memory 

When using chip selects to access emulation memory, the DSACKx signals can be 
generated internally or externally. 

If the DSACKx signals are generated externally (as defined by the 
CF_CSXMASK register), emulation memory must be interlocked with the target 
system (use the dsi attribut e when ma pping the emulation memory range); 
otherwise, there will be no DSACKx response. 

Fast Termination Mode 

Emulation memory does not support the fast termination mode (- 1 wait state) that 
can be defined in the chip select registers. If a chip select is programmed for this 
mode, it will override the mapper and force access to the target system. 

External DMA Access to Emulation Memory 

External direct memory access (DMA) to emulation memory is not permitted. The 
internal 68340 DMA controller modules can access emulation memory. 
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To map memory ranges 

1 Answer "yes" to the "Modify memory configuration?" question. 

2 Enter the address range, memory type, and optionally an attribute for the memory 
range. 

You can characterize memory ranges as emulation RAM, emulation ROM, target 
system RAM, target system ROM, or as guarded memory. 

Guarded memory accesses will cause emulator execution to break into the monitor 

program. 

Writes to locations characterized as ROM will cause emulator execution to break 
into the monitor program if the "Break processor on write to ROM?" trace/debug 
configuration option is enabled. 

Even though execution breaks into the monitor, the memory location is modified if 
it's in emulation ROM or target system RAM mapped as ROM. 

For the HP 64751 emulator, the attributes can be: 

dp Dual-port emulation memory. 

One emulation memory range, up to 4 Kbytes in length, can be 
given the dp attribute. The dp attribute specifies that the range 
be mapped to the 4 Kbyte block of dual-port emulation 
memory. If a foreground monitor program is selected, the dp 
attribute is automatically assigned to the memory range 
reserved for the monitor program. 

dsi Interlock emulation memory and target system /DSACK. 

The dsi attribute specifies that accesses in that range of 
emulation memory be synchronized with the target system. 
This means the termination of accesses in the range will not 
occur until the target system provides a /DSACK. If the target 
system does not generate a /DSACK, the emulator will be 
unable to break into the monitor and a "CPU in wait state" 
status will result. 
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csO 



dp_dsi 
dp_csO 
dsi_csO 
dp_dsi_csO 



When interlocking is disabled, accesses to emulation memory 
will be terminated by a /DSACK signal generated by the 
emulator. Any cycle termination signals generated by the target 
system during emulation memory accesses, including /BERR, 
will be ignored. 

Use 68340 chip select 0. 

The csO attribute allows you to emulate the 68340' s global chip 
select operation. One memory range, either target or emulation, 
can be given this attribute. Refer to the "To emulate global 
chip select operation" task description at the end of this section. 

Combination of the dp and dsi attributes. 

Combination of the dp and csO attributes. 

Combination of the dsi and csO attributes. 

Combination of the dp, dsi, and csO attributes. 



Examples 



Consider the following section summary from the linker load map output listing. 



SECTION SUMMARY 



SECTION 


ATTRIBUTE 


START 


END 


LENGTH 


ALIGN 




ABSOLUTE DATA 


00000000 


0000002F 


00000030 


0 


(BYTE) 


0 


NORMAL 




00000030 


00000030 


00000000 


2 


(WORD) 


env 


NORMAL 


CODE 


00000400 


00000FB8 


00000BB9 


2 


(WORD) 


prog 


NORMAL 


CODE 


OOOOOFBA 


00001A83 


OOOOOACA 


2 


(WORD) 


const 


NORMAL 


ROM 


00001A84 


00001AC9 


00000046 


2 


(WORD) 


lib 


NORMAL 


CODE 


OOOOIACA 


0000265D 


00000B94 


2 


(WORD) 


libc 


NORMAL 


CODE 


0000265E 


0000487B 


0000221E 


2 


(WORD) 


libm 






0000487C 


0000487C 


00000000 


0 


(BYTE) 


mon 


NORMAL 


CODE 


0000487C 


000049C5 


0000014A 


2 


(WORD) 


envdata 


NORMAL 


DATA 


00007000 


00007155 


00000156 


4 


(LONG) 


data 


NORMAL 


DATA 


00007156 


00007721 


000005CC 


2 


(WORD) 


idata 






00007722 


00007722 


00000000 


0 


(BYTE) 


udata 






00007722 


00007722 


00000000 


0 


(BYTE) 


libdata 


NORMAL 


DATA 


00007724 


00007727 


00000004 


4 


(LONG) 


libcdata 


NORMAL 


DATA 


00007728 


00008153 


00000A2C 


2 


(WORD) 


mondata 


NORMAL 


DATA 


00008154 


00008177 


00000024 


2 


(WORD) 


stack 


NORMAL 


DATA 


OOOOBOOO 


00012FFF 


00008000 


4 


(LONG) 


heap 


NORMAL 


DATA 


00013000 


00016FFD 


00003FFE 


4 


(LONG) 
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Notice the ABSOLUTE DATA, CODE, and ROM sections occupy locations 0 
through 49C5H. Because the contents of these sections will eventually reside in 
target system ROM, this area should be characterized as ROM when mapped. This 
win prevent these locations from being written over accidentally. If breaks on 
writes to ROM are enabled, instructions that attempt to write to these locations will 
cause emulator execution to break into the monitor. 

Also, notice the DATA sections occupy locations 7000H through 8177H and 
OBOOOH through 16FFDH. Since these sections are written to, they should be 
characterized as RAM when mapped. 

Enter the following commands to map memory for the above program. 
delete all <RETURN> 

0 thru 6fffh emulation rom <RETURN> 
7000h thru 16fffh emulation ram <RETURN> 

For the HP 64751 68340 emulator, to synchronize emulation memory accesses in 
the range 0 through 6FFFH, you would enter the following command in place of 
the command above: 

0 thru 6fffh emulation rom dsi <RETURN> 

To specify that the range 0 through 6FFFH is in supervisor program space, you 
would enter: 

0 thru 6fffh supervisor program emulation rom <RETURN> 

To exit out of the memory mapper, enter: 
end <RETURN> 



To characterize unmapped ranges 

1 Access the configuration questions. 

2 Answer "yes" to the "Modify memory configuration?" question. 

3 Use the default softkey to characterize unmapped ranges. 
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The default softkey in the memory mapper allows you to characterize unmapped 

memory ranges. Unmapped memory ranges are treated as target system RAM by 
default. Unmapped memory ranges cannot be characterized as emulation memory 

Examples To characterize unmapped ranges as target RAM: 

default target ram <RETURN> 

To characterize unmapped ranges as guarded memory: 
default guarded <RETURN> 

To exit out of the memory mapper, enter: 
end <RETURN> 



To delete memory map ranges 

1 Access the configuration questions. 

2 Answer "yes" to the "Modify memory configuration?" question. 

3 Use the delete softkey to delete mapped ranges. 

Note that programs should be reloaded after deleting mapper terms. The memory 
mapper may re-assign blocks of emulation memory after the insertion or deletion 
of mapper terms. 



Examples To delete term 1 in the memory map: 

delete 1 <RETURN> 

To delete all map terms: 
delete all <RETURN> 

To exit out of the memory mapper, enter: 
end <RETURN> 
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To map memory ranges that use function codes 

• Specify function codes with address ranges when mapping memory. 

Memory mapper softkeys that represent the different function codes are: 

supervisor 
user 
program 
data 

supervisor program 
supervisor data 
user program 
user data 

When you specify function codes with mapper ranges, the 68340 function code 
outputs (FCO, FCl, FC2) are decoded to select particular blocks of memory. 
Function codes let you overlay address ranges. When you specify function codes 
as part of the address, the emulator memory mapper knows that overlaid blocks are 
different memory regions and wiU define them separately. 

If you specify a function code when mapping a range of memory, you must include 
the function code when referring to locations in that range. If you don't include the 
function code, an "ambiguous address" error message is displayed. 

If you use different function codes, it's possible to map address ranges that overlap. 
When address ranges with different function codes overlap, you must load a 
separately linked module for the space associated with each function code. The 
modules are linked separately because linker errors occur when address ranges 
overlap. 

When address ranges are mapped with different function codes, and there are no 
overlapping ranges, your program modules may exist in one absolute file. 
However, you have to use multiple load commands — one for each function code 
specifier. This is necessary to load the various sections of the absolute file into the 
appropriate function code qualified memory ranges. When you do this, be sure that 
all address ranges not mapped (that is, the "other" memory mapper term) are 
mapped as target RAM. When "other" is mapped as guarded, guarded memory 
access errors (from the attempt to load the absolute file sections that are outside the 
specified function code range) can prevent the absolute file sections that are inside 
the specified function range from being loaded. 
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Examples Suppose you're developing a system with the following characteristics: 

• Input port at 100 hex. 

• Output port at 400 hex. 

• Supervisor program from 1000 through Ifff hex. 

• User program from 3000 through 3fff hex. 

• User data from 3000 through 3fff hex. 

Notice that the last two terms have address ranges that overlap. You can use 
function codes to cause these terms to be mapped to different blocks of memory. 

Suppose also that the only things that exist in your target system at this time are the 
input and output ports and some control logic; no memory is available. You can 
reflect this by mapping the I/O ports to target system memory space and the rest of 
memory to emulation memory space with the following mapper commands: 

Oh thru Offfh target ram <RETURN> 

lOOOh thru Ifffh supervisor program emulation rom 

<RETURN> 

3000h thru 3fffh user program emulation ram <RETURN> 
300 Oh thru 3fffh user data emulation ram <RETURN> 



To emulate global chip select operation 

These steps apply to the HP 64751 68340 emulator. 

1 Use the csO attribute when mapping the boot ROM address range. 

2 Make sure the CF_MBAR register is valid, and modify the CF_CSOADDR and 
CF_CSOMASK registers to appropriate values. 

Or: 

Load a previously saved configuration that has appropriate values of CF_MBAR, 
CF_CSOADDR, and CF_CSOMASK. 
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3 If the you're emulating boot ROM with emulation memory, load the boot ROM 
code. 

4 Run from reset. 
The advantages are: 

• You can put the boot ROM contents in emulation memory. 

• The base address of the boot ROM does not have to be at address 0 to fetch 
vectors from reset. 

• If boot ROM is already in the target system, you can prevent guarded memory 
accesses when running from reset. 

Limitations: 

The maximum amount of emulation memory that can be mapped is half the amount 
of memory installed in bank 1 or one quarter the amount of memory installed in 
bank 0, whichever is larger. 
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Configuring tlie Emuiator Pod 

In order to configure the emulator pod, you must first start the configuration 
interface and access the "Emulator Pod Settings" configuration section (refer to the 
previous "Using the Configuration Interface" section). 

This section shows you how to: 

• Interlock emulator and target DSACKs. 

• Enable coverage memory. 

• Set the reset values of the Supervisor Stack Pointer and the Program Counter. 

• Set the value of the MM bit in SIM_MCR. 

• Set the user memory access size. 



To interlock DSACKS 

• Answer the question: 

Interlock DSACKs? 

yes interlocks emulator and target system cycle termination signals 

for monitor accesses. 

no terminates monitor accesses with only the emulator-generated 

cycle termination signals. 

When you en able inter locking, emulation monitor cycles aren't termi nated u ntil the 
target system DSACKis received. The emulator will also respond to BERR signals 
from the target system. If you disable interlocking, emulator-generated signals wiU 
terminate the cycle and the target system signals will be ignored. 

This configuration item only applies to the map term defined for the monitor. For 
other memory ranges, refer to "To assign memory map terms." 
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If you enable the interl ock, and the monitor is in an address range where the target 
system does not return DSACK, the emulator will stop. If this happens, use the 
Execution^Reset to Monitor command to reset the processor. Then disable the 
interlock. 

Remember that foreground monitor bus cycles are visible to the target system. If 
you disable the interlock, your target system may operate erratically if it is not 
prepared for the emulation monitor bus cycles. 



To allow BERR to terminate emulation memory 
access 

• Answer the "Bus error on emulation memory access?" question. 

no The target system's BERR signal is NOT allowed to terminate 

a processor cycle to emulation memory. 

yes The target system's BERR signal will be allowed to terminate a 

processor cycle to emulation memory. 

A BERR generated internally to the microprocessor will always be able to 
terminate a bus cycle. 

The target systems BERR signal will always be able to terminate a processor cycle 
to target memory. 



To set the bus during reset 

1 Answer the question, "Source for value driven on the data bus during reset?" 

emulator The emulator is the source of the value that is placed on the 

data bus during reset. 
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target The target system is the source of the value that is placed on the 

data bus during reset. 

The value is used by the processor to determine the configuration of some of the 
processor's pins. 

2 Answer the question, "Value to be driven onto the data bus during reset =" . 

Enter the value that is placed on the data bus during reset. The value is used by the 
processor to determine the configuration of some of the processor's pins. 



To set the reset values of the SSP and PC 

1 Enter an even address in response to the "Reset value for Supervisor Stack 
Pointer?" question. 

2 Enter an even address in response to the "Reset value of the Program Counter?" 
question. 

When using a foreground monitor, the supervisor stack pointer must be set to an 
address in emulation or target system RAM in order for the emulator to transition 
into the run state, to step, or to perform other functions after emulation reset. 

The "Reset value ... ?" configuration questions set the initial SSP and PC values 
after emulation reset. Upon the transition from emulation reset into the emulation 
monitor, the supervisor stack pointer register and the program counter are set to the 
values specified, which must be 32-bit hexadecimal even addresses. 

If a run from reset command is given, this configuration item has no affect and the 
initial supervisor stack pointer and program counter will be retrieved from reset 
vector in the vector table. 

When using the background monitor, the initial values set in response to the "Reset 
value ... ?" configuration questions are also used to set up the SSP and PC after 
emulation reset; however, this is not necessary for proper emulator operation. If a 
target system reset occurs while running in the background monitor, the supervisor 
stack pointer and program counter are unaffected. 
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To specify the user memory access size 

• Answer the "User memory access size?" question. 

When accessing target system memory locations or single-port emulation memory 
locations, the access mode specifies the type of microprocessor cycles that are used 
to read or write the value(s). For example, when the access mode is byte and a 
target system location is modified to contain the value 12345678H, byte 
instructions are used to write the byte values 12H, 34H, 56H, and 78H to target 
system memory. 

Answer "bytes" if the emulator should make 8-bit accesses to target system 
memory. 

Answer "words" if the emulator should make 16-bit accesses to target system 
memory. 

Answer "longs" if the emulator should make 32-bit accesses to target system 
memory. 
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Setting the Debug/Trace Options 

In order to set the debug/trace options, you must first start the configuration 
interface and access the "Debug/Trace Options" configuration section (refer to the 
previous "Using the Configuration Interface" section). 

This section shows you how to: 

• Enable/disable breaks on writes to ROM. 

• Trace background cycles. 



To enable/disable breaks on writes to ROM 

1 Access the configuration questions. 

2 Answer "yes" to the "Modify trace/debug options?" question. 

3 Answer "yes" to the "Break processor on write to ROM?" question to enable 
breaks; answer "no" to disable breaks. 

When breaks on writes to ROM are enabled: 

The emulator will break into the emulation monitor whenever the user 
program attempts to write to a memory region mapped as ROM. 

Even though execution breaks into the monitor, the memory location is 
modified if it's in emulation ROM or target system RAM mapped as ROM. 

When breaks on writes to ROM are disabled: 

The emulator will not break to the monitor upon a write to ROM. 
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To trace background cycles 

• Answer "background" or "both" to the "Trace background or foreground 
operation?" question. 

Answering "background" specifies that the analyzer trace only background cycles. 
This is rarely a useful setting for user program debugging. 

Because the 68340 background monitor is implemented using the 68340 
background debug mode (BDM), only memory accesses are captured when tracing 
background cycles. 

Answering "both" specifies that the analyzer trace both foreground and background 
cycles. You may wish to specify this option so that all emulation processor cycles 
may be viewed in the trace display. 



To automatically update chip select registers 

• Answer the "Turn on automatic update of emulator chip select registers?" question. 

yes The emulator will issue a modify cs_tables emul_cs_reg 

analysis memory timing on the first entry into the monitor after 
an emulation reset and the first entry into the monitor after 
running user code. This command will setup the emulator based 
on the chip select registers at these times. 

no The emulator will NOT issue a modify cs_tables emul_cs_reg 

analysis memory timing on the first entry into the monitor after 
an emulation reset and the first entry in the monitor after 
running user code. 

These registers are also set up when the following debugger command is executed: 
Debugger Execution Environment Unrestricted 
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Configuring the HP 64780, HP 64782, 
or HP 64749 Emulator or the 
HP Software Probe 

How to configure the HP 64780 (68360), HP 64782 (6833x), or HP 64749 (6833x) 
emulator, or the HP E3490A (HP Software Probe) for your target system. 
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This chapter describes how to configure the emulator. You must map memory 
whenever you use the emulator. When you plug the emulator into a target system, 
you must configure the emulator so that it operates correctly in the target system. 
The configuration tasks are grouped into the following sections: 

• Using the configuration interface. 

• Verifying the emulator configuration. 

The simulated I/O feature and configuration questions are further described in the 
Simulated I/O User's Guide. 

The interactive measurement configuration options are described in the 
emulator/analyzer graphical interface manual. 

When you have developed an emulation configuration, saved it to a file, and closed 
the configuration interface, you can use the File— >Load— ^Emulator Config... 
command and associated dialog box in the debugger interface to load the 
configuration file into your emulator. 



Note If you are using the HP Software Probe, some of the configuration items described 

in this chapter do not apply. For example, you cannot map memory with the 
HP Software Probe. The HP Software Probe User's Guide provides detailed 
information on some of the configuration items, such as setting the processor clock 
rate. 
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To start the configuration interface 

• Choose Modify^Emulator Config... from the debugger interface pulldown menu. 

• Using the command line, enter the modify configuration command. 

The configuration interface top-level dialog box (see the following example) is 
displayed. 

The configuration sections that are presented depend on the hardware and the 
features of your particular emulator. 

The configuration interface may be left running while you are using the debugger 
and emulator/analyzer interfaces. 

If you're using the standard interface from a terminal or terminal emulation 
window, you don't get a dialog box from which to choose configuration sections; 
however, you have access to the same configuration options through a series of 
configuration questions. 
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Examples The 68360 emulator configuration interface top-level dialog box is shown below. 



The menu bar. 



Clicking on one of these^ 
lines selects a particillar 
configuration section 



Clicking this button 
loads any configuration 
changes into the \ 
emulator. 



Emulator Configuration: hplsds2 (mBB360) 



□I 




ile Display 

Emulator Configuration Sections 
-HQ General Items / Monitor Setup 

□ Reconfigure Internal Registers 

□ Memory Map 

□ Emulator Pod Settings 

□ Debug/Trace Options 
O Simulated 10 



Help 



jVAnalyzer Configuration Sections 

□ Interactive Measurement Specifieation 



Apply to Emulator 



piisi 



lis portion of the dialog box displays 
configuration status information. 
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To modify a configuration section 

1 Start the emulator configuration interface. 

2 Click on a section name in the configuration interface top-level dialog box. 

3 Use the section dialog box to make changes to the configuration. 

As soon as you change a configuration option, the change is recorded (as seen by 
the "Changes Not Loaded" message in the top level dialog). 
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Most configuration sections provide dialog boxes similar to the following. 



The dialog for 
this section has 
been opened 



Applies 
configuration 
changes to the 
emulator 



Configuration 
options in this 
section 




Emulator Con tigii r ation: hplsds2 (riibUytlU] 



File Display 

f Emulator Configuration Sections 
O General Items / Monitor Setup 
□ Reconfigure Internal Registers 
O Memory Map 
O Emulator Pod Settings 
LH Debug/Trace Options 
O Simulated 10 



Analyzer Configuration Sections- 



n Interactive Measurement Specification 




Emulator 




Emulator Configuration: Debug Options 



j-Debug/Trace Options 

Break on Write to ROM ^ Yes O No 
Brealt on Memory Violation # Yes ^ No 



Trace Mode (Type of Cycles) Foreground o 



OK 




Cancel 




Help 



Help 



Closes the Cancels all changes since 

dialog box last "OK" , "Apply to 

Emulator", or store to fUe. 



Presents emulator 
configuration help 
topic browser. 
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To apply configuration clianges to the emuiator 

• Click the "Apply to Emulator" button in the top-level dialog box. 

This loads the configuration changes into the emulator. Status text to the right 
shows whether the load was successful. 

You can apply configuration changes to the emulator at any time (even while 
section dialog boxes are open). This lets you verify changes without closing 
section dialog boxes. 

The "Apply to Emulator" button does not store configuration changes to a file. 

When you exit the configuration interface and there are configuration changes that 
have not been stored to a file, you are asked whether you want to store the changes, 
exit without storing, or cancel the exit. 
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If apply to emulator falls 

n Choose Display^Failed Apply Info from the pulldown menu in the top-level 
configuration interface window. 

A window containing the following information about the failed configuration is 
opened: 

• Chip select information from the emsim (emulator) resister set. 

• Bus interface port information from the emsim (emulator) resister set. 

• The expanded memory map. 

• Reset mode configuration information. 

• A complete hst of the configuration inconsistencies. This list is not limited to 
16 messages as is the Display— ^Configuration Info^Diagnostics command. 

This information is shown in the same format as output from the various 
Display^Configuration Info^ commands. 

Because the old configuration is reloaded when an apply to emulator fails, the 
information displayed in this window is different from the information displayed 
by the Display^Configuration Info^ commands (which display information 
about the coirfiguration currently loaded). 

Refer to the "Verifying the Emulator Configuration" section later in this chapter for 
details on these types of configuration information displays. 
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To store configuration changes to a file 

• Choose File^Store... from the pulldown menu in the top-level configuration 
interface window, and use the file selection dialog box to name the configuration 
file. 

• If you are using the Softkey Interface, the last configuration question, 
"Configuration file name?", lets you name the file to which configuration 
information is stored. If you don't enter a name, configuration information is saved 
to a temporary file (which is deleted when you exit the interface and release the 
emulation system). 

When modifying a configuration using the Graphical User Interface, you can store 
your answers at any time. 

Configuration information is saved in a file with the extension " .EA" . This file is 
the "source", ASCII format copy of the fUe. (The interface will create a temporary 
file with the extension ".EB" which is the "binary" or loadable copy of the file.) 



CAUTION Do not modify configurations by editing the ".EA" fUes. Use the configuration 
interface to modify and save configurations. 
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To change the configuration directory context 

• Choose File^Directory... from the pulldown menu in the top-level configuration 
interface window, and use the directory selection dialog box to specify the new 
directory. 

The directory context specifies the directory to which configuration files are stored 
and from which they are loaded. 



To display the configuration context 

• Choose Display^Context... from the pulldown menu in the top-level 
configuration interface window. 

The current directory context and the current configuration files are displayed in a 
window. Click the "Done" pushbutton when you wish to close the window. 



Emulator Configuration: Current Context 



« Directory: /usryhp64000yiibyXl iyHP64_schemes/HP-UX 

« Configuration File: /usrnip64000/iib/Xl 1/HP64_sciiemes/HP-UXrconfig 



Done 



X 
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To access help topics 

• Choose Help^General Topic... from the pulldown menu in the top-level 
configuration interface window, cUck on a topic in the selection dialog box, and 
click the "OK" button. 



To access help for a configuration item in a 
dialog box 

• Place the mouse pointer on the line of interest and press the f 1 key. 

• Choose Help^On Item... from the pulldown menu in the top-level configuration 
interface window. The mouse pointer changes from an arrow to a question mark. 
Place the question mark over a selection button or in the entry field on the Une of 
interest, and click any mouse button. 

The configuration interface provides individual help for each item in the top level 
dialog box and throughout the coirfiguration section dialog boxes. 

If you are having trouble using the f 1 key to obtain help, you may be able to use the 
question mark obtained by the Help— >On Item... pulldown. If the Help— >On 
Item... pulldown does not obtain the desired result, try the f 1 key. The operation of 
these two selections differs on different platforms. 

In some dialog boxes, the question mark obtained by the Help^On Item... 

pulldown may not obtain a help screen when you place it on a command name, but 
the help screen may be obtained when you place the question mark over an input 
field or button associated with the command name. 



309 



Chapter 10: Configuring the Emulator 



To exit the configuration interface 

• Choose File^Exit... from the pulldown menu in the top-level configuration 
interface window (or type <CTRL>x). 

If configuration changes have not been stored to a file, a confirmation dialog box 
appears, giving you the options of: storing, exiting without storing, or canceling the 
exit. 



To load an existing configuration fiie 

• In the debugger interface, choose File^Load^Emulator Config... from the 
pulldown menu, and use the file selection dialog box to specify the coirfiguration 
file to be loaded. 

• Using the command line, enter the load configuration <FILE> command. 

This command loads previously created and stored configuration files. You cannot 
load a configuration while the configuration interface is running. 
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Verifying tlie Emulator Configuration 

The emulator lets you display information about emulator configuration and 
processor SIM programming. You can also display information about 
inconsistencies found in the emulator configuration. 

This section shows you how to: 

• Display information about chip selects. 

• Display information about bus interface ports. 

• Display information about the memory map. 

• Display information about the reset mode configuration. 

• Display assembly language instructions for setting up the SIM. 

• Check for configuration inconsistencies . 



To display information about chip selects 

• Choose Display^Configuration Info^Chip Selects (SIM) or 

Display^Configuration Info^Chip Selects (Emulator SIM) from either the 
coirfiguration interface or the debugger interface pulldown menu. 

The debugger will display chip select iirformation from the sim (processor) register 
set or the emsim (emulator) register set. 

The resulting display shows: 

How the chip select is assigned. 
The base address. 
The block size. 

Other information from the option register. 
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To display information about bus interface ports 

• Choose Display^Configuration Info^Bus Interface Ports (SIM) or 

Display^Configuration Info^Bus Interface Ports (Emulator SIM) from either 
the configuration interface or the debugger interface pulldown menu. 

The debugger will display information about bus interface Port E pin assignments 
from the sim (processor) register set or the emsim (emulator) register set. 



To display information about the memory map 

• Choose Display^Configuration Info^Memory Map from either the 
configuration interface or the debugger interface pulldown menu. 

When in the memory map section of the emulator configuration, the ranges of 
memory that have been mapped are displayed. 

The memory map configuration information shows detailed information about the 
memory map, current programming of the chip selects in the EMSIM and EMRAM 
register sets, and processor resources. 
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To display information about the reset mode 
configuration 

• Choose Display^Configuration Info^Reset Mode Value from either the 
configuration interface or the debugger interface pulldown menu. 

The display will show data bus size and global chip select memory access size. 



To review the upper address mode of the present 
configuration (68360) 

• Choose Display^Configuration Info^Upper Address Mode from either the 
configuration interface or the debugger interface pulldown menu. 

This selection will show whether the upper address bits are used as A31-A28 or 
WE3-WE0. 
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To display information about the present clock 
input mode (68360) 

• Choose Display^Configuration Info^Clock Input Mode from either the 
configuration interface or the debugger interface pulldown menu. 

The clock mode depends on the clock module installed in the emulation probe. 
Refer to the Hewlett-Packard MC68360 Emulator/Analyzer 
Installation/Service/r erminal Interface User's Guide for details. 



To display assembly language instructions for 
setting up the SIM 

• Choose Display^Configuration Info— ^Initialization Source Code from either 
the configuration interface or the debugger interface pulldown menu. 

This selection displays the assembly language program that will initialize the 
processor as defined by the current EMSIM register contents. 
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To check for configuration inconsistencies 

• Choose Display^Configuration Info^Diagnostics from either the configuration 
interface or the debugger interface pulldown menu. 

This selection: 

• Checks for inconsistencies between the emulator and the EMSIM registers. 

• Checks for inconsistencies between the reset mode configuration value and the 
EMSIM registers. 

• Compares corresponding values in the SIM and EMSIM register sets. 

This command identifies errors that result from inconsistencies between related 
configuration values. These errors should be resolved in order for the emulator to 
operate correctly. 

This command also provides status and warning messages about expectations and 
limitations of the emulator of which you should be aware. 

If no messages are returned, no inconsistencies are found in the emulator 
configuration. 



315 



Chapter 10: Configuring the Emulator 
Verifying the Emulator Configuration 



To verify the emulator configuration 

1 Choose Display^Configuration Info^Memory Map from either the 
configuration interface or the debugger interface pulldown menu to display 
information about the memory map and its correlation with chip selects, internal 
module register block, and RAM. 

This shows more detailed information about the memory map. If foreground 
monitor is selected, the map will include the map term for the foreground monitor. 

2 Choose Display^Configuration Info^Chip Selects (Emulator SIM) from 
either the configuration interface or the debugger interface pulldown menu to 
display information about chip selects. 

A table appears. It shows the current values in the emsim (Emulator Copy) register 
set. 
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Configuring tlie HP 64749 Emulator 
Mapping memory 

Using Emulation lUlemory to Substitute for 8-Bit lUlemory 

Emulation memory is 16-bit wide memory. However, you can use emulation 
memory to substitu te for 8-bi t memory by using one of the chip selects and 
generating internal DS AC Kx signals for an 8-bit port. You must place the 
appropriate values into the emulator configuration (EMSIM) versions of the chip 
select address and mask registers so that emulation memory is accessed correctly. 

Using Chip Selects to Access Emulation Memory 

When using chip selects to access emulation memory, the DSACKx signals can be 
generated internally or externally. 

If the DSACKx signals are generated externally (as defined by the EMCSORx 
register), /DSACK interloc k for emul ation memory accesses must be enabled; 
otherwise, there will be no DSACKx response. 

Fast Termination Mode 

Emulation memory will support chip selects configured for fast termination enable 
(-1 wait state). However, to allow sufficient emulation memory access time, the 
system clock frequency must be limited to 8 MHz. 

Data Strobe Qualified Chip Selects 

Emulation memory will support chip selects configured as data strobe qualified. 
However, to allow sufficient emulation memory access time, at least one wait state 
must be used or the system clock frequency must be limited to 8 MHz. 
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To map memory ranges that use function codes 

• Specify function codes with address ranges when mapping memory. 

The function code can be: 

X (no function code is used — absolute files are loaded into memory ranges 

that have been mapped without function codes). 

s (supervisor space). 

u (user space). 

p (program space). 

d (data space). 

sp (supervisor program space), 
sd (supervisor data space), 
up (user program space), 
ud (user data space). 

Function code information lets you further characterize memory blocks as 
supervisor, user, supervisor program, supervisor data, user program, or user data 
space. When you specify function codes with mapper ranges, the function code 
outputs (FCO, FCl, FC2) are decoded to select particular blocks of memory. 
Function codes let you overlay address ranges. When you specify function codes 
as part of the address, the emulator memory mapper knows that overlaid blocks are 
different memory regions and will define them separately. 

If you specify a function code when mapping a range of memory, you must include 
the function code when referring to locations in that range. If you don't include the 
function code, an "ambiguous address" error message is displayed. 

If you use different function codes, it's possible to map address ranges that overlap. 
When address ranges with different function codes overlap, you must load a 
separately linked module for the space associated with each function code. The 
modules are hnked separately because linker errors occur when address ranges 
overlap. 

When address ranges are mapped with different function codes, and there are no 
overlapping ranges, your program modules may exist in one absolute file. 
However, you have to use multiple load commands — one for each function code 
specifier. This is necessary to load the various sections of the absolute file into the 
appropriate function code quaUfied memory ranges. When you do this, be sure that 
all address ranges not mapped (that is, the "other" memory mapper term) are 
mapped as target RAM. When "other" is mapped as guarded, guarded memory 
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access errors (from the attempt to load the absolute file sections that are outside the 
specified function code range) can prevent the absolute file sections that are inside 
the specified function range from being loaded. 



Examples Suppose you're developing a system with the following characteristics: 

• Input port at 100 hex. 

• Output port at 400 hex. 

• Supervisor program from 1000 through Ifff hex. 

• Supervisor data from 2000 through 2fff hex. 

• User program from 3000 through 3fff hex. 

• User data from 3000 through 3fff hex. 

Notice that the last two terms have address ranges that overlap. You can use 
function codes to cause these terms to be mapped to different blocks of memory. 

Suppose also that the only things that exist in your target system at this time are the 
input and output ports and some control logic; no memory is available. You can 
reflect this by mapping the I/O ports to target system memory space and the rest of 
memory to emulation memory space by entering the following mapper commands 
(using the command line): 

Oh thru Offffh target ram <RETURN> 

lOOOh thru Ifffh supervisor program emulation rom <RETURN> 
2000h thru 2fffh supervisor data emulation ram <RETURN> 
3000h thru 3fffh user program emulation ram <RETURN> 
3000h thru Sfffh user data emulation ram <RETURN> 

After the configuration is saved, display memory at lOOOH by entering the 
following command (using the command line): 
display memory lOOOh blocked bytes <RETURN> 

Notice that an "ambiguous address" error occurs because the "sp" function code 
was not included with the address. The following command should have been 
entered instead: 

display memory fcode sp lOOOh blocked bytes <RETURN> 
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To map memory ranges that use chip selects 

• Specify chip selects with address ranges when mapping memory. 

The chip select can be: 

csbt (csboot chip select). 

csO through cslO (chip select 0 through 10). 

csx,y (chip selects x and y together where x and y are any of the 12 chip 
selects (2, 3 or, 4 allowed as a function code)). 

Usually, you do not have to specify chip select function codes when mapping 
memory because the emulator automatically assigns chip selects to address ranges 
based on the contents of the EMSIM registers, specifically the EMCSBRx and 
EMCSORjc chip select base and option registers. You can view the assignment of 
chip selects to actual mapper resources by entering the Display^Configuration 
Info— ^Memory Map command. 

However, if you wish to change what has automatically been assigned, you can 
specify chip select function codes with address ranges when mapping memory. 



Examples Suppose you enter the following mapper commands (using the command Une): 

Oh thru Offfh target ram <RETURN> 
lOOOOh thru Iffffh emulation ram <RETURN> 
60000h thru Vffffh target ram <RETURN> 
SOOOOh thru 9ffffh emulation ram <RETDRN> 
OffeSOOh thru Offefffh emulation ram <RETURN> 
default guarded <RETURN> 

Also suppose the EMSIM registers define chip selects as shown by the following 
DispIay^Configuration Info^Chip Selects (Emulator SIM) command. 



The following table reflects the current values in the emsim register set. 
These values will be loaded into the processor when the monitor is 
entered from emulation reset. 



Select 


Assign 


Base 


Size 


Mode 


Byte 


R/W 


Strb 


DSACK 


Space 


IPL 


AVEC 


CSBOOT 


16- 


-bit 


060000H 


128K 


async 


both 


read 


AS 


2wait 


s/u 


all 


off 


CSO 


16- 


-bit 


OOOOOOH 


64K 


async 


upper 


write 


AS 


Owait 


s/u 


levelV 


off 


CSl 


16- 


-bit 


OOOOOOH 


64K 


async 


lower 


write 


AS 


Owait 


s/u 


levelV 


off 


CS2 


16- 


-bit 


OOOOOOH 


64K 


async 


both 


read 


AS 


Owait 


s/u 


levelV 


off 


CS3 


16- 


-bit 


OOOOOOH 


2K 


async 


off 


rsvd 


AS 


Owait 


cpu 


all 


off 


CS4 


16- 


-bit 


FFF800H 


2K 


async 


both 


read 


AS 


Owait 


cpu 


level? 


on 


CSS 


16- 


-bit 


FFE800H 


2K 


async 


both 


both 


AS 


Owait 


s/u 


levelV 


on 


CS6 


16- 


-bit 


080000H 


128K 


async 


lower 


both 


AS 


3wait 


s/u 


all 


off 


CSV 


16- 


-bit 


080000H 


128K 


async 


upper 


both 


AS 


3wait 


s/u 


all 


off 
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CS8 16-bit OlOOOOH 64K async both read AS Iwait s/u all off 
CS9 16-bit OlOOOOH 64K async lower write AS Owait s/u all off 
CSIO 16-bit OlOOOOH 64K async upper write AS Owait s/u all off 

Based on the contents of the EMSIM registers, the Display^Configuration 
Info^Memory Map command gives the following information: 



This shows more detailed information about the memory map and how it has been 
expanded (possibly) due to the current programming of the chip selects in 
the emsim and emram register set. 



Entry 


Range 




Type 




Fcode 


Att 


Comment 




info 


FFFOOOH- 


FFFFFFH 


reg block 


sd 








1 


OOOOOOH- 


OOFFFFH 


targ 


ram 


cs2 








1 exp 






targ 


ram 


csO, 1 








1 exp 






targ 


ram 


csO 








1 exp 






targ 


ram 


csl 








2 


OlOOOOH- 


OlFFFFH 


emul 


ram 


cs8 


blk2 






2 exp 






emul 


ram 


cs9, 10 


blk2 






2 exp 






emul 


ram 


cslO 


blk2 






2 exp 






emul 


ram 


cs9 


blk2 






3 


060000H- 


07FFFFH 


targ 


ram 


csbt 








3 exp 


OOOOOOH- 


OlFFFFH 


targ 


ram 


csbt 




for reset 


access 


4 


080000H- 


0 9FFFFH 


emul 


ram 


cs6, 7 


blk4 






4 exp 






emul 


ram 


cs7 


blk4 






4 exp 






emul 


ram 


cs6 


blk4 


! ERROR! no 


map resources 


5 


FFE800H- 


FFEFFFH 


emul 


ram 


cs5 




! ERROR ! no 


map resources 


auto 


FFFFOOH- 


FFFFFFH 


cpu space 


cs4 




! ERROR! no 


map resources 




other addresses 


guarded 











First of all, notice that "other addresses" are mapped as guarded memory. One easy 
way to fix the memory map so that the emulator doesn't run out of actual mapper 
resources is to map "other addresses" as target RAM. This way, the address ranges 
mapped as target RAM won't take up mapper resources because they are the same 
as the "other addresses" memory type. 

However, there may be other ways to reduce the number of actual mapper 
resources required. For example, if you know your code doesn't perform any byte 
writes (only reads), you can remove the mapper resources for when: 

• CSO alone is active. 

• CSl alone is active. 

• CS9 alone is active. 

• CS 10 alone is active. 
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To do this, you would enter the following mapper commands (using the command 
line): 

delete all <RETURN> 

Oh thru Offffh chip_select csO and csl target ram <RETURN> 
Oh thru Offffh ch±p_select cs2 target ram <RETURN> 
lOOOOh thru Iffffh chip_select cs8 emulation ram blkl <RETURN> 
lOOOOh thru Iffffh chip_select cs9 and cslO emulation ram blkl 

<RETURN> 

eOOOOh thru 7ffffh target ram <RETURN> 
SOOOOh thru 9ffffh emulation ram <RETURN> 
OffeSOOh thru Offefffh emulation ram <RETURN> 
default guarded <RETURN> 

Now, when you display the memory map information, notice that fewer actual 
mapper resources are used. 

This shows more detailed information about the memory map and how it has been 
expanded (possibly) due to the current programming of the chip selects in 
the emsim and emram register set. 



Entry 


Range 




Type 


Fcode 


Att 


Comment 


info 


FFFOOOH- 


FFFFFFH 


reg block 


sd 








1 


OOOOOOH- 


OOFFFFH 


targ ram 


csO, 1 








2 


OOOOOOH- 


OOFFFFH 


targ ram 


cs2 








3 


OlOOOOH- 


OlFFFFH 


emul ram 


cs8 


blkl 






4 


OlOOOOH- 


OlFFFFH 


emul ram 


cs9, 10 


blkl 






5 


060000H- 


07FFFFH 


targ ram 


csbt 








5 exp 


OOOOOOH- 


OlFFFFH 


targ ram 


csbt 




for 


reset access 


6 


080000H- 


0 9FFFFH 


emul ram 


cs6, 7 


blk3 






6 exp 






emul ram 


cs7 


blkS 






6 exp 






emul ram 


cs 6 


blk3 






7 


FFE800H- 


FFEFFFH 


emul ram 


cs5 








auto 


FFFFOOH- 


FFFFFFH 


cpu space 


cs4 




for 


int. ack. cycles 




other addresses 


guarded 











To display information about tlie memory map 

• Choose Display^Configuration Info^Memory Map from either the 
configuration interface or the debugger interface pulldown menu. 

When in the memory map section of the emulator configuration, the ranges of 
memory that have been mapped are displayed. 
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The memory map configuration information shows detailed information about the 

memory map and how actual mapper resources are allocated due to the current 
programming of the chip selects in the EMSIM and EMRAM register sets. 

When the emulator automatically expands the memory map to assign actual 
mapper resources, it looks at ranges that have been mapped during emulator 
configuration. Single ranges, mapped without chip select function codes, may 
actually be expanded to use multiple mapper resources based on whether: 

• The EMSIM register contents show multiple chip selects for the same or 
overlapping address range. If this is the case, mapper resources are allocated 
for each overlapping address range. Additional resources are allocated when 
certain upper/lower byte and read/write options are defined. 

• The EMCSBRBT register defines the boot ROM address range starting at an 
address other than 0. If the boot ROM range is in emulation memory, an 
additional mapper resource that points to the same block of emulation memory 
but which starts at address 0 is allocated. If the boot ROM range is target 
memory and the "other" mapper term specifies guarded memory, an additional 
mapper resource is allocated to prevent a guarded memory access when the 
emulator comes out of reset. 

• The "default" mapper term specifies guarded memory. If this is the case, an 
additional mapper resource using the cpu space function code is allocated in 
preparation for interrupt acknowledge cycles. 

If you wish to override the automatic allocation of memory mapper resources, you 
can specify chip select function codes with address ranges when mapping memory. 

Note that only 12 actual mapper resources are available. The memory map 
configuration information tells you when the emulator is out of mapper resources. 
When this happens, you can map "default" addresses as target memory or specify 
chip select function codes when mapping memory to reduce the automatic 
allocation of mapper resources. 
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To display information about the memory map and its correlation with chip selects, 
internal module register block, and RAM, choose Display^Configuration 
Info^Memory Map from either the configuration interface or the debugger 
interface pulldown menu. 

This shows more detailed information about the memory map and how it has been 
expanded (possibly) due to the current programming of the chip selects in 
the emsim and emram register set. 



Entry Range Type Fcode Att Comment 



info FFFOOOH- FFFFFFH reg block sd 

1 OOOOOOH- OOFFFFH targ ram same as other type 

2 OlOOOOH- OlFFFFH emul ram cs8 blkl 
2 exp " " emul ram cs9,10 blkl 
2 exp " " emul ram cslO blkl 

2 exp " " emul ram cs9 blkl 

3 060000H- 07FFFFH targ ram same as other type 

4 080000H- 09FFFFH emul ram cs6, 7 blk2 
4 exp " " emul ram cs7 blk2 

4 exp " " emul ram cs6 blk2 

5 FFE800H- FFEFFFH emul ram cs5 
other addresses targ ram 



Examples 



Notice the entry labeled "info". Ranges with this label do not take up mapper 
resources; they just show information about the processor's address space. Another 
"info" entry will be hsted if the intemal RAM is enabled with the EMRAMBAR 
register. 
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Configuring for Motorola BCC or EVS Target 
Systems 

The instructions in this section assume you're using the emulator in Normal mode. 
This section shows you how to: 

• Configure the emulator. 

• Map memory. 

• Verify the emulator configuration. 



To configure the emulator 

• Configure the emulator so that it's in Normal mode and uses the target system 
clock. 

In the general section: 

Emulator mode? normal 
Micro-procesor clock source? external 

In the reconfigure intemal registers section: 

Initial value of the emulator copy of SIM_MCR = 42CFH 
Initial value of the emulator copy of SYNCR = 7F08H 
Initial value of the emulator copy of PICR = OFH 
Initial value of the emulator copy of PITR = OOH 
Initial value of the emulator copy of SYPCR = 06H 
Initial value of the emulator copy of PORTE = OFFH 
Initial value of the emulator copy of PORTF = OFFH 
Initial value of the emulator copy of DDRE = OOH 
Initial value of the emulator copy of DDRF = OOH 
Initial value of the emulator copy of PEPAR = OFFH 
Initial value of the emulator copy of PFPAR = OFFH 
Initial value of the emulator copy of CSPDR = 7FH 
Initial value of the emulator copy of CSPARO = 3FFFH 
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In the emulator pod settings section: 

Source for value driven on the data bus during reset? emulator 
Value to be driven onto the data bus during reset = OH 



326 



Chapter 10: Configuring the Emulator 
Configuring for lUlotoroia BCC or EVS Target Systems 



To map memory 

The emulator configuration should set up the following memory map: 

0000000 - OOOffffh tram (csO,l,2) 

0010000 - OOlffffh eram (cs8,9,10) 

0060000 - OOVffffh tram (csboot) 

0080000 - 009ffffh eram (cs6,7) 

OffeSOO - OffEfffh eram (cs5) 



Map memory by entering the following mapper commands (using the command 
hne): 

0 thru Offffh target ram <RETURN> 
lOOOOh thru Iffffh emulation ram <RETURN> 
eOOOOh thru 7ffffh target ram <RETURN> 
SOOOOh thru 9ffffh emulation ram <RETURN> 
OffeSOOh thru Offefffh emulation ram <RETURN> 
end <RETURN> 
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To verify the emulator configuration 

1 Choose Display^Configuration Info^Memory Map from either the 
configuration interface or the debugger interface pulldown menu to display 
information about the memory map and its correlation with chip selects, intemal 
module register block, and RAM. 



This shows more detailed information about the memory map and how it has been 
expanded (possibly) due to the current programming of the chip selects in 

the emsim and emram register set. 
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2 Choose Display-^Configuration Info^Chip Selects (Emulator SIM) from 
either the configuration interface or the debugger interface pulldown menu to 
display information about chip selects. 



The following table reflects the current values in the emsim register set. 
These values will be loaded into the processor when the monitor is 

entered from emulation reset. 
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X Resources and the Graphical Interface 

This chapter helps you to understand how to set the X resources that control the 
appearance and operation of the debugger's graphical interface. This chapter: 

• Explains the X Window concepts surrounding resource specification. 

• Explains the scheme files used by the debugger' s graphical interface. 

The debugger's graphical interface is an X Window System apphcation which 
means it is a client in the X Window System client-server model. 

The X server is a program that controls all access to input devices (typically a 
mouse and a keyboard) and aU output devices (typically a display screen). It is an 
interface between application programs you run on your system and the system 
input and output devices. 

An X resource is user-definabie data 

A resource is a user-definable piece of data that controls the operation or 
appearance of an X Windows application. A resource may apply to an application 
(application- specific resources) or it may apply to the objects called widgets from 
which the apphcation is constructed. That is particularly true of standard widget 
resources that control the appearance of an application. For example, most widgets 
have a standard resource that allows the user to specify the font used to display text 
on objects like buttons, menus, and labels. 

An application-specific resource is defined by the application developer and may 
control such things as the mode of operation of an application. For example, you 
can use an application-specific resource for the debugger's graphical interface to 
control whether to start the interface with the command line on or the command 
line off. 

A resource specification is a name and a value 

Each resource in an application has a name and a value. Because an X Window 
System application is constructed from widgets, a resource name is closely 
associated with the names of the widgets that make up the application. Each 
application begins with a top-level widget that is the parent of all other widgets in 
the application. The name of the top-level widget is usually the same as that of the 
application. This top-level widget may have a number of widgets "beneath" it that 
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are called children of the top-level widget. The names for these widgets are most 
often chosen for their mnemonic value. These children can also in turn have child 
widgets. A resource name, then, is simply a name of a piece of data for the 
lowest-level widget coupled with a string of widget names picked up from each of 
the widgets along the path starting with the top-level widget and going down to the 
lowest-level widget. 

The data name and widget names within a resource name are separated from each 
other by dots. The resource name itself is terminated by a colon. A resource value 
is simply the data value itself. Ignoring the widget names and data name for the 
moment, a common resource for most widgets is color. A data value for color 
might be "blue." 

To put this all together, a resource string for the foreground color for the "quit" 
pushbutton displayed on an application called "tracker" might look Uke the 
following: 

tracker .panel . control . quit . foreground : white 

Don't worry, there are shortcuts 

As you might guess, specifying resources for apphcations with many levels of 
widgets can be difficult and error-prone. For that reason, you can use a shortened 
notation. To fully understand how the notation works, however, you must first 
understand about instance names and class names. 

An instance name is a name given to a particular widget by an application 
developer. You have already seen instance names used. The name "quit" is an 
instance name for a pushbutton widget used by the developer of the "tracker" 
application from the last example. An instance name makes the pushbutton widget 
named "quit" unique from other pushbutton widgets in the "tracker" application. 

A class name is a general name for all widgets of a particular type. For example, 
the class name for the OSF/Motif pushbutton widget is XmPushButton. When you 
refer to a widget in an application by its class name, you are referring to all widgets 
of that class in the application, and not to just a particular widget. 

Instead of specifying the foreground color for the tracker quit button by using a 
resource name made up of instance names as in the last example, you could instead 
use a class name, as follows: 

tracker . panel . control . XmPushbutton . foreground: white 
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Using class names in this way makes it easier to specify resources because it 
relieves you from having to discover the names of particular widgets in an 
application. A long string of instance names or class names is still a long string of 
names, however. Fortunately, a wildcard helps to make the shortcut a true shortcut. 
The wildcard is an asterisk ("*"). It can be used to replace any number of class or 
instance names in a resource name. The last example could now be shortened to 
either of the following: 

tracker*XinPushButton . foreground: white 
tracker*quit . foreground : white 

But wait, there is trouble ahead 

An X Window System appUcation maintains a complete list of resources, and the 
application knows the complete instance and class names for each resource. 
Because you can specify resource values using shortened notation, the application, 
when starting up, must match specified values to individual resources. Some 
general rules apply: 

• Either a class name or instance name from the request must match each class 
or instance name in the appUcation' s list of resources. 

• Entries prefixed by a dot are more specific and therefore have precedence over 
entries prefixed by an asterisk. 

• Instance names are more specific and therefore have precedence over class 
names. 

• Matching is done from left to right. Instance or class names appearing at the 
beginning of the specification have precedence over those later in the 
specification. 

As you can quickly see, resource matching favors specific resource names over 
general resource names. General resource names, especially those involving class 
names, can have unexpected and unintended effects. Consider the last example 
again. The resource specification 

tracker*XinPushButton . foreground: white 

may not only set the foreground color of the quit button on the control panel of the 
application to white — it could also set the foreground colors for any pushbutton 
anywhere in the application. That is because the combination of the wildcard and 
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the use of the class name make this resource specification match a resource request 
for any pushbutton in the appUcation. 

The second of the two specifications in the example does not completely solve the 
problem either. Suppose there was another button elsewhere in the application 
with the instance name of "quit." (DupUcating instance names is correct as long as 
the widget paths to two different widgets of the same name are different.) The 

second specification of 

tracker*quit . foreground : white 

could match a resource request for that button as well because the wildcard allows 
the specification to match a number of different widget paths through the 
application. 

Resource specification is usually a matter of trial and error. The following resource 
is probably specific enough to set just the foreground color for the quit button on 
the control panel: 

track.er*control*quit . foreground: white 

To view the resources in the debugger's graphical interface, you can choose 
Help^X Resource Names and click on the "All names" button. 

Class and instance apply to applications as well 

Just as there are classes and instances of widgets, there are classes and instances of 
X Window applications. Resource specifications can be constructed in such a way 
that they apply to a whole class of applications, or just to an instance of those 
applications. 

The class name for the debugger graphical interface products is HP64_Debug. The 
instance of the class that this debugger graphical interface falls under is called 
debug. A few examples are in order. 

• For a given resource (called <resource>), the following specification applies to 
all debugger interface products for all processors: 

HP64_Debug*<resource> : <value> 

• The following specifications apply to all <class> debugger interfaces: 
HP64_Debug. <class>*<resource> : <value> 

debug . <class>*<resource> : <value> 
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According to the precedence rules for resource matching, the first specification is 
the most general and would be overridden by either of the following two. 

Resource specifications are found in standard places 

X resources are defined in standard places so that applications can find them and 
use them when starting up. 

The app-defaults file 

The app-defaults file contains only resources for a specific application. The system 
directory for apphcation default files is: 

HP-UX $HP64000Aib/Xll/app-defaults 

SunOS /usr/openwinAib/Xll/app-defaults 

The name of the default file is the same as the class name for the application and is 
also called the app-defaults file (for example, HP64_Debug is the name of the 
debugger's graphical interface's apphcation defaults file). 

These defaults should not be changed by individual users because doing so affects 
the appearance and behavior of the application for all users of the application. 

The .Xdefaults file 

The .Xdefaults file in your $HOME directory usually contains user-defined 
resources for several applications. 

Scheme files 

X resource specifications can point to scheme fdes in which other X resources are 
specified. 

Loading order resolves conflicts between files 

If there are two files, then which resource specification from which file controls the 
resource in the application? That problem is solved by adhering to a loading order 
for files. The following is a list of the standard places, in order, that an application 
looks to find resources: 

1 The apphcation default file. 
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The application default file for the graphical interface is called HP64_Debug. 
This file is created at software installation time and placed in the system 
application defaults directory. 

2 $XAPPLRESDIR/<class> 

This environment variable defines an alternative directory path leading to 
customized class files. Useful for directing the application to system-wide 
custom files. 

3 RESOURCE_MANAGER property. Some X servers have a resource property 
associated with the root window for the server. Resources are added to the 
resource property database by using xrdb. (HP VUE is an example.) The 
server can use this property to access those resources. 

If no RESOURCE_MANAGER property exists, then $HOME/.Xdefaults is 
read. The primary and probably best method for creating or adding to this file 
is by copying part or aU of the app-defaults file into the .Xdefaults file. 

4 $XENVIRONMENT file. This environment variable defines a file that 
contains resource specifications. 

If the XENVIRONMENT variable is not set, then SROME/.Xdefaults-host is 
read. 

5 Command line options 

Resources can be specified on the command line by using the -xrm command 
line option. The application strips these arguments out and sets these resources 
before passing the rest of the command Une on to the application. 

Remember, load order specifies the precedence for resource overrides. A resource 
found later in the load order overrides a resource found earlier in the load order if 
the resource specifications match each other. 

The app-defaults file documents the resources you can 
set 

The HP64_Debug file is complete, well-commented, and a good source of 
reference for graphical interface resources. The HP64_Debug file should be your 
primary source of information about setting graphical interface resources. This file 
can be easily viewed from the help topic menu by choosing Help^General Topic 
and selecting the "X Resources: Setting" topic. 



337 



Chapter 1 1 : X Resources and the Graphical Interface 

To further assist you with setting X resources, there is also another topic on the 
help menu pull-down that you should use. Choose Help— >X Resource Names to 
display the class and instance name for the graphical interface in a dialog box. 
From the dialog box, you can also display all widget class and instance names for 
all widgets that make up the debugger's graphical interface. In most cases, you 
will not need to delve that far into the widget tree, but it is there if you need it. 

In addition to the app-defaults file, the graphical interface uses scheme files. 
Resources are not duplicated between scheme files and the HP64_Debug file. You 
may wish to set resources found in the scheme files as well, so you need to 
understand how scheme files relate to the interface and to the other X resource files. 

Scheme files augment other X resource files 

Hewlett-Packard realizes that the debugger's graphical interface will be run in 
environments made up of workstations with different display capabilities and even 
in environments with different types of computers (platforms) running the X 
Window System. The debugger's graphical interface, unlike many other X 
applications, makes determinations about display hardware as to the platform type, 
the resolution of the display, and whether the display is color or monochrome. The 
interface then loads the appropriate scheme files to allow the interface to come up 
in a reasonable way based on the hardware. 

There are six scheme files. Their names and a brief description of the resources 
they contain follows: 

Defines the labels for the fixed text in the interface. Such 
things as menu item labels and similar text are in this file. 
If the $LANG environment variable is set, the scheme file 
"Debug.$LANG" is loaded if it exists; otherwise, the tile 
"Debug.Label" is loaded. 

Defines the color scheme for black and white displays. 
This file is chosen if the display caimot produce at least 16 
colors. 

Defines the color scheme for color displays. This file is 
chosen if the display can produce 16 or more colors. 

Defines the button and key bindings for the mouse and 
keyboard. 



Debug .Label 




Debug.BW 



Debug.Color 
Debug.Input 
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Debug.Large 



Defines the window dimensions and fonts for high 
resolution display (1000 pixels or more vertically). 



Debug.Small 



Defines the window dimensions and fonts for low 
resolution displays (less than 1000 pixels vertically). 



Debug.Label (or Debug. $LANG) resides in the directory 
/usr/hp64000/lib/Xl l/HP64_schemes. This directory is the upper level directory 
for scheme files. The other five files are in subdirectories below this one named by 
platform (or operating system). For example, the HP 9000 scheme files are in the 
subdirectory /usr/hp64000/lib/Xll/HP64_schemes/HP- UX. 

Like the app-defaults file, these scheme files are system files and should not be 
modified directly. 

You can create your own scheme files, if you choose 

The debugger's graphical interface supports user-defined scheme files. The 
interface searches two places for user-defined scheme files and loads any it finds 
after loading the system scheme files. Refer to any of the scheme files mentioned 
for iirformation about where to place your own scheme files. 

Scheme files continue the load sequence for X resources 

Scheme files extend the load order for finding X resources. System scheme file 
resources override all other resources gathered so far, and user-defined scheme 
files, in tum, override the system scheme files. Continuing from the load order list 
previously, the scheme files follow, in the order 

1 /usr/hp64000/lib/X 1 l/HP64_schemes/Debug.Label 
/usr/hp64000/lib/Xll/HP64_schemes/<platform>/Debug.<scheme> 

2 $XAPPLRESDIR/HP64_schemes/Debug.Label 
$XAPPLRESDIR/HP64_schemes/<platform>/Debug.<scheme> 

Just as $XAPPLRESDIR can point to a system-wide app-defaults fUe, so can it 
point to a set of system- wide scheme files. 

3 $HOME/.HP64_schemes/Debug.Label 
$HOME/.HP64_schemes/<platform>/Debug.<scheme> 

Please note the dot (.) in the ".HP64_schemes" directory name. 
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You can force the debugger's graphical interface to use 
certain schemes 

Five application-specific resources allow you to force the interface to use certain 
schemes. The resources and what they control are as follows: 

HP64_Debug .platf ormS cheme : 

Controls the platform scheme chosen by the interface. This resource is 
particularly useful in mixed-platform environments where you might be 
executing the interface remotely on an HP 9000 computer, but displaying the 
interface on a Sun SPARCsystem computer. In this situation, you may wish to 
set the resource to use the SunOS scheme so that you can use the same key and 
mouse button bindings as other Sun OpenWindows applications. 

The value of this resource is actually the name of a subdirectory under 
/usr/hp64000/lib/Xll/HP64_schemes or one of the alternative directories for 
scheme files. You can create your own file and subdirectory under 
/usr/hp64000/lib/Xll/HP64_schemes (or alternative) and then set this resource 
to choose that subdirectory instead of the standard platform subdirectory. 

Values can be: HP-UX, SunOS, or the name of a sub-directory containing 
custom scheme fUes. 

HP64_Debug.colorScheme: 

Chooses the black and white or color scheme. 

Values can be: Color, BW, or the name of a custom scheme file. 

HP64_Debug.inputScheme: 

Chooses the keyboard and mouse bindings. 

Values can be: Input or the name of a custom scheme file. 

HP64_Debug.sizeScheme: 

Chooses the large or small scheme for fonts and sizes. 

Values can be: Large, Small, or the name of a custom scheme file. 

HP64_Debug .labelScheme : 

Chooses a different label scheme for fixed text. Again, this resource is 
affected by the $LANG variable. 
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Values can be: Label, $LANG (if this environment variable is set and there is a 
Debug.$LANG scheme fUe), or the name of a custom scheme file. 

These resources are in the app-defaults fUe. To override these resources, set them 
in your .Xdefaults fUe. 

Again, setting X resources is a trial and error process. The scheme files used by the 
debugger's graphical interface simplify the process by collecting related resources 
in specific files. 

To review the organization: 

• The app-defaults file contains resources that control the operation of the 
interface. To override a resource in this file, copy the resource to your 
.Xdefaults file and change it there. 

• Resources that control the appearance of the display and keyboard and mouse 
button bindings for your platform are in the scheme files. Copy the scheme 
files to an appropriate place and modify the resources found in them to change 
the look of the interface. 

If you would rather place these resources in your .Xdefaults file, remember the 
load order. Make the resource name in the .Xdefaults file more specific or it 
will be overridden by the one in the scheme file. 

The app-defaults file and the scheme files are your best sources of reference for 
help with modifying individual resources. 

Resource setting - general procedure 
Application specific resources 

If you plan to modify an application-specific resource, you should look in the 
HP64_Debug file for information about that resource. 

If the RESOURCE_MANAGER property exists (as is the case with HP VUE), 
copy the complete HP64_Debug file, or just the part you are interested in, to a 
temporary file. Modify the resource in your temporary file and save the file. Then, 
merge the temporary file into the RESOURCE_MANAGER property with the 
xrdb -merge <lilename> command. 
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If the RESOURCE_MANAGER property does not exist, copy the complete 
HP64_Debug file, or just the part you are interested in, to your .Xdefaults fUe. 
Modify the resource in your .Xdefaults file and save the file. 

Finally, if the debugger's graphical interface is currently executing, you must exit 
and restart the interface for the change to have any effect. 

General resources 

If you plan to modify a general resource that could not be found in the 
HP64_Debug file, look to the scheme files for information about that resource. A 
general discussion of the kinds of information found in the scheme files can be 
found in the previous "Scheme files augment other resources" section. 

Copy the appropriate scheme file to one of the alternative directories and make the 
modifications there. (If you are using $XAPPLRESD1R, make sure the variable is 
set and exported.) Save the file. If the debugger's graphical interface is currently 
executing, you must exit the appUcation and restart it to see the results of your 
change. 
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Detailed descriptions of command line commands. 
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Command Summary 



Command 

Breakpt Access 
Breakpt Clear_All 
Breakpt Delete 
Breakpt Instr 
Breakpt Read 
Breakpt Write 
Breakpt Erase 



Breakpoint Commands 

Breakpoint commands control execution of a program. 
Definition 

Set a breakpoint on access (read/write) of an address 

Clear all breakpoints 

Delete specified breakpoints 

Set an instruction breakpoint 

Set a breakpoint on a read from an address 

Set a breakpoint on a write to an address 

Delete a breakpoint at a specific address 



Command 



Session Control Commands 

The session control commands select debugger operating modes, set debugger 
session options, define and display macros, allow access to the host operating 
system, and end debugger sessions. 

Definition 



Debugger ? 

Debugger Directory 

Debugger Execution Display_Status 

Debugger Execution Environment 

Debugger Execution IO_System 
Debugger Execution Load_State 
Debugger Execution Reset_Processor 
Debugger Host_Shell 
Debugger Level 



Access debugger on-Une help 

Display or change present working directory 

Display current directory and files in use 

Configure and control emulation environment 

Control debugger simulated I/O 

Restore previously saved debugger session 

Simulate microprocessor reset 

Enter HP-UX operating system environment 

Select debugger mode (high-level or assembly) 
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Debugger Macro Add Create a macro 

Debugger Macro Call Call a macro 

Debugger Macro Display Display macro source code 

Debugger Option Set or list debugger options for this session 

Debugger Pause Pause debugger session 

Debugger Quit Terminate a debugging session 



Expression Commands 

Expression commands calculate expression values, print formatted output to a 
window, and monitor variables. 



Command 



Definition 



Expression C_Expression 
Expression Display _Value 
Expression Fprintf 
Expression Monitor Clear_All 
Expression Monitor Delete 
Expression Monitor Value 
Expression Printf 



Calculate the value of a C expression 
Display the value of an expression or variable 
Print formatted output to a window 
Discontinue monitoring all variables 
Discontinue monitoring specified variables 
Monitor variables 

Print formatted output to Journal window 



File Commands 

File commands read and process command files, open files or devices for writing, 
log debugger commands to a file, and save debugger startup parameters. 



Command Definition 

File Command Read in and process a command file 

File Error_Command Set command file error handling 

File Journal Send Joumal Window output to a file or the browser 

File Joumal Browser Send journal output to a graphical browser window 

File Log Record debugger commands/errors in a file 

File Startup Save the default startup options 
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File User_Fopen Open a file or device for read or write access 

File Window_Close Close the file associated with a window number 



Memory Commands 

Memory commands do operations on the target microprocessor's memory. 



Command 


Definition 


Memory Assign 


Change the values of memory locations 


Memory Block_Operation Copy 


Copy a memory block 


Memory Block_Operation Fill 


Fill a memory block with values 


Memory Block_Operation Match 


Compare two blocks of memory 


Memory Block_Operation Search 


Search a memory block for a value 


Memory Block_Operation Test 


Examine memory area for invalid values 


Memory Display 


Display memory contents 


Memory Flash 


Program or erase flash memory 


Memory Hex 


Read or write Intel Hex or Motorola S-Record memory images 


Memory Register 


Change the contents of a register 


Memory Unload_BBA 


Unload BB A data from program memory 
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Program Commands 

Program commands load and execute programs, control program execution, display 
source code and program variables, and set or cancel program interrupts. 



Command 

Program Context Set 
Program Context Display 
Program Context Expand 

Program Display_Source 

Program Find_Source Occurrence 

Program Find_Source Next 

Program Load 

Program Pc_Reset 

Program Run 

Program Step 

Program Step With_Macro 



Definition 

Specify current module and function scope 

Display all local variables of a function 

Display all local variables of a function at the specified stack 
(backtrace) level 

Display C source code 

Find first occurrence of a string 

Find next occurrence of a string 

Load or reload an absolute file for debugging and set load options 
Reset the program starting address 
Start or continue program execution 
Execute a number of instructions or lines 
Execute macro after each instruction step 



Symbol Commands 

Symbol commands add. remove, and display symbols. 



Command Definition 



Symbol Add Add a symbol to the symbol table 

Symbol Browse Browse C++ class 

Symbol Display Display symbol, type, and address 

Symbol Remove Delete a symbol from the symbol table 
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Trace Commands 

Trace commands let you do bus level tracing of your program activity with bus 
cycle store qualification of data. 



Command 


Definition 




oioii a ticiL'C uaiiix tiic loot uciiiicu ui^^ci uiiu uuciiiiiL'aiiuii iciiiia 




T^^iQnlfiv tmpp infnrmatinn iti flip Vipw winHnw 
ui^Lfiay iidL'^ iiiiuiiuciinjii 111 111^ view WlllUUW 


T'rfipp Pvpnt r^lpfit* All 


r^lpnt* ^^fPTnnvp^ all HpfinpH pvpntc 
\_-iccii v^i ciinj y^/ all uciiiicu c V ciiis 


Trarp Rvptit Dplptp 


Dplptp "^TiPcifipH pvpnt'^ 

1 — • ^ 1 ^ LV^ l}I_/^^1-L1wU ^ V ^AAViJ 


T'fdr'P TnA/pnt T ict 


T icttpftnc /'pnTiHitinTic^ nf ct^ppifipH PA/ptit 

i-/10L ICllilO ^^L-UllUlUUllO^ Ul OUCL-lllCU CVClll 


Trace Event Specify 


Define an event (combination of bus conditions) 


Trace Event Used_List 


List summary of trace events in the View window 


Trace Halt 


Stop the current trace 


Trace StoreQual 


Specify the bus conditions to be stored (captured) 


Trace StoreQual Event 


Specify a previously defined event to be stored (captured) 


Trace StoreQual List 


List the current storage qualification terms 


Trace StoreQual None 


Disable current storage quahfication terms (store everything) 


Trace Trigger 


Specify the bus conditions to be used to trigger (start) a trace 


Trace Trigger Event 


Specify a previously defined event to be used as the trigger 


Trace Trigger List 


List the current trigger terms in the View window 


Trace Trigger Never 


Disable current trigger terms (start trace on any bus state) 



Window Commands 

Window commands do operations on the debugger windows. 



Command Definition 

Window Active Activate a window 

Window Cursor Set the cursor position for a window 

Window Delete Remove a user-defined window or screen 

Window Erase Clear data from a window 

Window New Make a new screen or window 
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Window Resize Change the size of a window 

Window Screen_On Activate a screen 

Window Toggle_View Select the alternate display of a window 
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Breakpt Access 



Breakpt ^}~~*(^ Access 



<addr> 




<Return> 





.<addr> 



:<macro call> 



This command is not available if you are using an HP Software Probe. 

The Breakpt Access command sets an access breakpoint at the specified memory 
location (<addr>) or range (<addr>..<addr>). The access breakpoint halts program 

execution each time the target program attempts to read from or write to the 
specified memory location or range. Memory locations may contain code or data. 

You can attach a macro to a breakpoint using the optional <macro_call> parameter. 
See the chapter titled "Using Macros and Command files". 

Each time the debugger detects an access of the address or range, it does the 
following: 

1 Suspends program execution. 



Sometimes execution may stop a few instructions past the instruction causing 
the access. This is called "skid." 



Execution will stop immediately following the current instruction. 

2 Executes a macro (if you attached one to the breakpoint). Depending on the 
macro retum value, the debugger does one of the following actions: 

- If the macro return value is true (nonzero), the debugger resumes 
execution at the instruction indicated by the PC. No breakpoint 
information is displayed. 

- If the macro retum value is false (zero), the debugger returns to 
command mode and displays breakpoint information. 
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3 Returns to command mode if no macro was attached and displays breakpoint 
information. 

Interaction with trace commands 

The Breakpt Access and Trace Trigger commands both use emulation analyzer 
resources. If access breakpoints are active (indicated by TRC : BrkRWA on the 
status line), then a Trace Trigger command may not be entered. If a trace trigger is 
active, a Breakpt Access command may not be entered. 



Note If a trace is started using the emulator interface, debugger read/write/access 

breakpoints will be disabled until the trace has been completed. Do not attempt to 
use the debugger read/write/access breakpoints and the emulator interface trace 

specification feature at the same time. 



The Breakpt Access command sets up a trace with the trigger at the end of the trace 
buffer, using the current storage quahfication. You can display the trace after the 
break occurs to see the cycles leading up to the break. 



See Also 

Breakpt Clear_All 
Breakpt Delete 
Breakpt Erase 
Breakpt Instr 



Breakpt Read 
Breakpt Write 
Program Run 
Program Step 



Examples To set a breakpoint on accesses of addresses 'assign_vectors' through 

'assign_vectors' + 16: 

Breakpt Access &assign_vectors . . +1 6 

To set a breakpoint on access of the address of the variable 'current_temp' : 

Breakpt Access &current_temp 

To stop program execution when the value of variable system_running is set or 
read as TRUE: 

Breakpt Access 6isystem_running; when ( system_running==l ) 

The predefined macro 'when' is executed when the breakpoint is encountered. 
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Breakpt Clear_AII 



Breakpt j M Clear_A 



<Return> 



The Breakpt Clear_All command clears (removes) all defined breakpoints. 

See Also 

Breakpt Access Breakpt Read 

Breakpt Delete Breakpt Write 

Breakpt Erase Program Run 

Breakpt Instr Program Step 



Examples To remove all defined breakpoints: 

Breakpt Clear_all 
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Breakpt Delete 



c 



Breakpt 




Delete 




G 



<brkpt_nmbr> 





<Return> 



..<brkpt_nmbr> 



The Breakpt Delete command deletes (removes) one or more previously set 
breakpoints. When you set a breakpoint, the debugger assigns it a breakpoint 
number. Use this breakpoint number (<brkpt_nmbr>) to remove a specific 
breakpoint. You can delete a group of breakpoints by specifying a range of 
breakpoint numbers (<brkpt_nmbr>..<brkpt_iimbr>). The debugger displays the 
breakpoint numbers in the Breakpoint window. 

When you remove a breakpoint, the Breakpoint window displays the remaining 
breakpoints. Any breakpoints following the one removed are renumbered. 



See Also 



Breakpt Access 
Breakpt Clear_All 
Breakpt Erase 
Breakpt Instr 



Breakpt Read 
Breakpt Write 
Program Run 
Program Step 



Examples 



To delete breakpoint number 2: 



Breakpt Delete 2 



To delete breakpoint numbers 3 through 5: 



Breakpt Delete 3.. 5 
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Breakpt Erase 



(^Breakpt '^^^ Erase 



<addr> 




<Return> 





.<Qddr> 



B3051S04 



The Breakpt Erase command erases (deletes) a previously set breakpoint at a 
specific address or all breakpoints set within a range of addresses. The Breakpt 
Erase command differs from the Breakpt Delete command in that you identify the 
breakpoint(s) you wish to remove by an address or by a range of addresses instead 
of by a breakpoint number. 

When you remove a breakpoint, the Breakpoint window displays the remaining 
breakpoints. Any breakpoints following the breakpoints (s) removed are 
renumbered. 



See Also 

Breakpt Access Breakpt Read 

Breakpt Clear_All Breakpt Write 

Breakpt Delete Program Run 

Breakpt Instr Program Step 



Examples To delete breakpoint set at the entry to the main( ) function: 

Breakpt Erase main 

To delete a breakpoint set at the symbol num_checks: 
Breakpt Erase &nuin_check:s 
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Breakpt Instr 



Breakpt ^ ^^)~*{ ^ Instr 



<addr> 




<Return> 





.<addr> 



;<macro call> 



The Breakpt Instr cormnand sets an instruction breakpoint at a specified memory 
location (<addr>) or range (<addr>..<addr>). The instruction breakpoint halts 
program execution each time the target program attempts to execute an instruction 
at the specified memory location(s). If you specify a range, the debugger sets 
breakpoints on the first word of each instruction within the specified range or (in 
high-level mode) the first instruction of each line within the range. 

If you set a breakpoint for an overloaded C++ function, the debugger will ask you 
to choose which definition of the function to use. You can also specify the 
argument type of the function definition in parentheses after the function name in 
the Breakpt Instr command. 



Note 



The debugger/emulator cannot set instruction breakpoints on address locations in 
target ROM. 



You can attach a macro to a breakpoint using the optional <macro_call> parameter. 
See the "Using Macros and Command Files" chapter. 

The debugger performs the following actions when it encounters an instruction 
breakpoint: 

1 Suspends program execution before the program executes the instruction at the 
breakpoint address. 

2 Executes a macro (if you attached one when you set the breakpoint). 
Depending on the macro return value, the debugger does one of the following 
actions: 
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- If the macro return value is true (nonzero), the debugger resumes 
execution starting at the instruction where the break occurred. No 
breakpoint information is displayed. 

- If the macro return value is false (zero), the debugger returns to 
command mode without executing the instruction where the break 
occurred and displays breakpoint information. 

3 Retums to command mode without executing the instruction where the break 
occurred if no macro was attached and displays breakpoint information. 

See Also 

Breakpt Access Breakpt Write 

Breakpt Clear_All Program Run 

Breakpt Delete Program Step 

Breakpt Read 



Examples To set an instruction breakpoint at line 82 of the current module: 

Breakpt Instr #82 

To set an instruction breakpoint at line 83 of the current module only when the 
system is running (using the predefined macro 'when'): 

Breakpt Instr #83; when (sYStem_running) 

To set an instruction breakpoint starting at address lOdeh and ending at address 
10e4h: 

Breakpt Instr 10deh..l0e4h 

To set instruction breakpoints beginning on lines 15 through 25 of module 
'initSystem': 

Breakpt Instr initSYstem\#15 . . #25 
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Breakpt Read 



Breokpt Read 



.<addr> 



<addr> 




<Return> 





:<macro call> 



See Also 



This command is not available if you are using an HP Software Probe. 

The Breakpt Read command sets a read breakpoint. The read breakpoint halts 
program execution each time the target program attempts to read data from the 
specified memory location (<addr>) or range (<addr>..<addr>). 

The Breakpt Read command behaves just like the Breakpt Access command. 
Breakpt Access 



Examples 



To set a breakpoint on reads from variable 'system_running': 
Breakpt Read &systein_running 

To set a read breakpoint starting at the address of variable 'current_temp' and 
ending 8 bytes after the address of 'current_temp': 

Breakpt Read &current_temp . . +8 

To stop program execution when the value of variable system_running is read as 
TRUE: 

Breakpt Read &system_running; when { system_running^^l ) 
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Breakpt Write 

Breakpt ^)-*(^ Write 





<addr> 




<Return> 






I : , j 






r 











See Also 



Examples 



This command is not available if you are using an HP Software Probe. 

The Breakpt Write command sets a write breakpoint. The write breakpoint halts 
program execution each time the target memory attempts to write data to the 
specified memory location (<addr>) or range (<addr>..<addr>). 

The Breakpt Read command behaves just like the Breakpt Access command. 
Breakpt Access 

To set a breakpoint to occur when the program writes a false value to variable 
' system_is_running' : 

Breakpt Write 6isystem_running; when (system_running==00) 

To set a write breakpoint starting at the address of global variable 'current_temp' 
and ending 8 bytes after the address of 'current_temp': 

Breakpt Write &current_temp . . +8 
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Debugger Directory 

^ Debugger ^}~*(^ Directory"^^'"^ — Show_Worl<ing~^ 




<Return> 



Change_Working^^)— »• <directory> 



The Debugger Directory command displays or ctianges the current working 
directory. When you specify the Show_Working parameter, the debugger displays 
the current working directory in the journal window. When you specify the 
Change _Working parameter with a directory name, the debugger makes that 
directory the current working directory. 

Changing the working directory will change the current working directory in all 
interfaces cormected to the emulator. 



Examples To display the current working directory: 

Debugger Directory Show_Working 

To change the current working directory to /users/project/sources: 

Debugger Directory Change_Working /users/project/sources 
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Debugger Execution Display_Status 



c 



Debugger 




Execution 



> 



< 



Display_Status 



*■ <Return> 



The Debugger Execution Display_Status command activates the debugger View 
window and displays the following status information: 

Version of debugger 
Current working directory 
Current log file 
Current journal file 

Startup file used in current debug session 
Loaded absolute files 

If no files have been loaded, the absolute file will be missing from the display. If 

multiple executable files have been loaded using the Program Load Append 
command, they will be displayed in the View window. You may need to toggle the 
window (click on the window border) to see all of the files. 



Example 



To display product version, current working directory, and current log, journal, 
startup, and absolute files in the View window: 



Debugger Execution DisplaY_Status 
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Debugger Execution Environment Cfgjnfo 



Debugger J)->-(^^B<ecution^^^)—>{^Environmenj)—*^ Cfg_lnfci 



»-( ^iagnostics 
^^--*-(^^Chip Selects^ 



Parts 



Mem 



oryMafA- 



ResetMode 



UpperAddr 



^^-^^ Clock \ 



InitCode 



<Return> 




EmutatorCopy 




EmulatarCopy 



bU73s03 



This command allows you to display information about the SIM module registers. 



Diagnostics 

ChipSelects 
Ports 

MemoryMap 
ResetMode 



Look for inconsistencies in the configuration of the SIM 
module registers. 

Show how the chip selects are set up. 

Show how the VO ports (C, E, and F) are set up. 

Show how emulator memory is mapped. 

Show how data lines 0-11 will be driven by the emulator at 
reset. 
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UpperAddr 



(68360) Show whether the upper address bits are used as 
A31-A28orWE3-WE0. 



Clock 



(68360) Show the clock mode. The clock mode depends 
on the clock module installed in the emulation probe. 
Refer to the MC68360 Emulator/Analyzer 
Installation/Service/T erminal Interface User's Guide for 
details. 



InitCode 



Generate an assembly language template that will set up 
the SIM registers as they are currently configured. Use this 
command once you get the SIM registers set up properly. 



The EmulatorCopy option shows the emulator copy of the SIM module registers. 



See also 



See the emulator manual for details of the operation of these registers. 
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Debugger Execution Environment FwdCmd 



(^Debugger "^)-H^ExGcut ion ^H^nvironmeri?)--^ FwdCmd 



— Emu I 



Perf 



BMS 



Debug 



ULname 



■<UI name>" — <Tab> 



'<CDmmand>'' ^ <Return> 



The Debugger Execution Environment FwdCmd command enables you to forward 
commands to other interfaces which are using the same emulator. 



The other interfaces are: 



Emul 

Perf 
BMS 

Debug 

UI name 



Emulator/analyzer interface. If several emulator interfaces 
are sharing the emulator, the command will be forwarded 
to the most recently started interface. 

Software Performance Analyzer. 

Broadcast Message Server (the Softbench Gateway). 

Debugger. This sends a command back to the debugger 
you are using. 

An interface described by a string. The command will be 
forwarded to an interface specified by a debugger or target 
string array (char *). 



If an interface of the type specified is currently running, the <command> will be 
executed there and any errors will be displayed in that interface. 



See Also 



Predefined macro "cmd forward". 
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Debugger Execution Environment Load_Config 

Debugger ^)~~*{^ Execution »{Environment)- 




Load_Config )— ► <"config_file"> <Return> 



The Debugger Execution Environment Load_Config command loads an emulation 
configuration file for the emulator. The emulation configuration file contains 
configuration information for the emulator. The debugger/emulator accepts files 
generated by the emulation software or by an editor. 



Note You cannot use tilde expansion when specifying emulator configuration files with 

the Debugger Execution Environment LoadjConfig < "configj'ile "> command 
because the configuration file name must be enclosed in quotation marks. 
However, you may use shell environment variables. 



See Also The "Configuring the Emulator" chapter for detailed information on the modify 

configuration command. 

Example To load the emulation configuration file "mycnfig" (from within the debugger): 

Debugger Execution Environment Load_Config "mycnfig" 

Or, if "mycnfig" is in another directory: 

Debugger Execution Environment Load_Config 
"$HOME/project /mycnfig" 
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Debugger Execution Environment Modify_Config 



<Return> 



The Debugger Execution Environment Modify_Config command starts a process 
which allows you to modify the current emulator configuration. 

See Also The "Configuring the Emulator" chapter in this manual. 
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Debugger Execution Environment SyncSli\/l 



(^Debugger \-H^Execution\-»-(^nviranmenl)-H^ SyncSIM \^ — "^^^TcT 



683XX 



Fram_683X^)-^ 
RestoreDflt\ 



Differences 



<Return> 



The emulator maintains copies of the processor SIM chip select registers so that it 
may interpret addresses properly for tracing and emulation memory. 

You can perform the following operations on these registers: 



To 683xx 



Copy the emulation registers to their corresponding 
processor registers. 



From 68 3 XX 



Copy the processor registers to their corresponding 
emulation registers. 



RestoreDflt 



Restore the processor registers to their default power-up 
values. 



Differences 



Compare the processor registers to their corresponding 
emulation registers. 



The emulator copies of these registers may be specified in the emulator 
configuration file. They will be copied to the processor upon reset or upon 
execution of the To_683xx command. Specifying them in the configuration file 
allows you to get started debugging without having to execute processor code to 
load these registers. 



See also 



See the emulator manual for details of the operation of these registers and the 
SYNC command. 
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Debugger Execution IO_System 




<Return> 



deidmn 



The Debugger Execution IO_System command enables you to configure the 
simulated VO system to use the host system keyboard, display, and file system to 
simulate I/O devices for your target program. 

Debugger Execution IO_System Enable 

The Debugger Execution IO_System Enable command enables the debugger 
simulated VO system. Remember, you also need to configure the emulator for 
simulated VO polling and addresses. 

Debugger Execution IO_System Disable 

The Debugger Execution IO_System Disable command disables the debugger 
simulated VO system. 



Debugger Execution IO_System Stdio_Redirect 

The Debugger Execution 10_System Stdio_Redirect command allows you to 
define the standard I/O input (<stdin_name>), output (<stdout_name>), and error 
(<stderr_name>) files/devices. These are file/device names in the host computer 
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file system. Two special filenames allow you to access the system keyboard 
(/dev/simio/keyboard) and the system display (/dev/simio/display). 

Debugger Execution IO_System Mode 

The Debugger Execution IO_System Mode command selects how keyboard 1/0 
input is processed. Keyboard I/O may be either cooked or raw. 

Cooked Mode, in cooked mode, the target program gets input from the 
keyboard in the form of lines. Editing operations, such as backspace, line kill, etc., 
on input is done by the debugger. When Return or CTRL D is entered, the line 
is passed to the target program by the simulated I/O system. The keyboard input is 
echoed to the screen during the editing operation. If program execution is 
interrupted by entering <Ctrl>-C before the hue is entered, the characters on the 
input line are lost. 

Raw Mode. In raw mode, each keystroke is passed from the keyboard to the 
simulated 1/0 system with no processing. No carriage return is needed to enter 
characters and no editing operations are available. In the raw mode any character is 
valid, including CTRL D. No characters are echoed to the screen upon entry. The 
only special character that cannot be sent to the target program is <Ctrl>-C which 
is used to interrupt the debugger's execution of the program. 

Debugger Execution IO_System Keyboard_EOF 

The Debugger Execution IO_System Keyboard_EOF command is retained only for 
compatibility with older interfaces. Using this command will result in an error 
message. 

Debugger Execution IO_System Report 

The Debugger Execution IO_System Report command displays the status of the 
simulated I/O system. 

See Also The "Using Simulated I/O" section in the "Viewing Code and Data" chapter. 



Examples To enable simulated I/O: 

Debugger Execution IO_System Enable 

To disable simulated I/O: 
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Debugger Execution IO_System Disable 

To redirect the standard input file to the keyboard, the standard output file to the 
display, and the standard error file to file Vusers/project/errorfile': 

Debugger Execution IO_System Stdio_Redirect 
" / dev/ simio/keyboard" , " / dev/ simio/ display" , 
" /users /pro ject /error file" 

To redirect the standard input file to 'temp.dat', the standard output file to 
'cmdoutdat', and the standard error file to file 'errorlog.err': 

Debugger Execution IO_System Stdio_Redirect 
"temp . dat " , " cmdout . dat " , "errorlog . err" 

To set data input mode to cooked: 

Debugger Execution IO_System Mode Cooked 
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Debugger Execution Load_State 



Debugger ^^)~* ^ Execution ^^)—-(^ Loacl_ State ^ 



<Return> 



<save file> 



The Debugger Execution Load_State command restores the memory contents and 
register values saved with the debugger/simulator Debugger Execution Save_State 
command. If you do not specify a file name (<save_file>), the debugger uses the 
default file db68k.sav. 



Example 



To restore memory contents and register values saved in save file "sessionl": 
Debugger Execution Load_State sessionl 
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Debugger Execution Reset_Processor 

Debugger^ *{^Execution^ H^Reset_ Processor^ 



<Return> 



This command resets the microprocessor and then attempts to break into the 
monitor. The reset is a hardware reset of the processor accomphshed by asserting 
the reset line. 

It does the following: 

1 The program counter is loaded from exception vector 1 at location 4 in 
memory. 

2 The interrupt stack pointer is loaded from exception vector 0 at location 0 in 
memory. 

3 The status register is reset as follows; 

- the trace bits are cleared, 

- the supervisor bit is set to 1 , 

- the interrupt priority mask is set to level 7. 

4 All other bits in the status register are set to 0. 

5 Any pending interrupt or exception is cleared. 

6 Registers A0-A6 and D0-D7 are set to 0. 

7 The emulator breaks into the emulation monitor. 



Note This command does not re -initialize memory. Use the Program Load New 

Code_Only command to reset C variables. 



See Also Program Pc_Reset 



Example To reset the microprocessor: 

Debugger Execution Reset_Processor 
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Debugger Host_Shell 




<Return> 



The Debugger Host_Shell command enables you to temporarily leave the 
debugging environment by forking an operating system shell or to execute a single 
UNIX operating system command from within the debugger. The type of shell 
forked is based on the shell variable SHELL. In this mode, you may enter 
operating-system commands. To return to the debugger, enter CTRL D or type 
exit and press the Return key. 

You can execute operating system commands from within the debugger by entering 
a single operating system command with the debugger Debugger Host_Shell 
command. If you are using the graphical interface, the operating system command 
is executed in a "cmdscript" window. Press <Return> to close the window. If you 
are using the standard interface, stdout from the command is written to the Journal 
window and stderr is not captured. Commands writing to stderr will corrupt the 
display. Interactive commands cannot be used in this mode. 

The following options are available only in the graphical user interface: 
InBrowser 

Directs stderr and stdout of the command into text browser windows. 
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Wait 

Suspends the interface until the command completes. 
NoPrompt 

When the command completes, the "cmdscript" window is closed immediatelly. 
See Also Debugger Quit 

Examples To temporarily exit the debugger to the UNIX operating system command mode: 

Debugger Host_Shell 

To write the current working directory to the joumal window: 
Debugger Host_Shell pwd 
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Debugger Help 



c 



Debugger 



?(Help) } 



<Return> 



This command displays the on-line help screen. The debugger provides on-Une 
help for all debugger commands, debugger command arguments, and debugger 
function keys. You can access on-line help by entering the command Debugger 
? or by pressing the F5 function key. 

If you are using the graphical interface, a Help dialog box will be displayed. If you 
are using the standard interface, a menu will appear in the display area. 

If you enter the command Debugger ? in the standard interface, the debugger 
puts the cursor at the top of the topic hst in the help menu. If you press the F5 
function key, the debugger puts the cursor at the entry for the command displayed 
on the command hne (if one is displayed). Otherwise, the cursor is positioned at the 
top of the topic list. You can select topics from the help menu in two ways: 

• Use the cursor keys to move to the desired topic and press the Return key. 

• Type the first letter of the desired topic. This positions the cursor at that topic. 
Then press the Return key. 

Use the Return key to see more topics in alphabetical order. 

To exit help in the standard interface, press the Esc (escape) key twice or press 
function key F5. 



Example 



To display the debugger help screen: 



Debugger ? 
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Debugger Level 




<Return> 



The Debugger Level command selects either high-level mode or assembly-level 
mode for debugging. When debugging programs containing C modules, you can 
switch back and forth between the two modes. If the program contains no 
high-level modules accessible to the debugger, the debugger displays an error 
message if you attempt to select high-level mode. 

If no parameters are specified with this command, the mode is switched back and 
forth between the two modes, performing the same function as the F3 function key. 



Examples To select the assembly-level debug mode: 

Debugger Level Assembly 

To select the high-level debug mode: 
Debugger Level High_Level 

To switch to the alternate debug mode: 
Debugger Level 
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The Debugger Macro Add command defines a macro. 

The name of the macro is specified by <macro_name>. The result type of the 
macro is specified by <type>. If a type is not specified, it defaults to type int. A 
parenthesized hst of parameters ( <param_l ist>) may optionally follow the 
macro name. Parameter names must be composed of alphanumeric characters. A 
maximum of 40 parameters is allowed. 

When you enter the Debugger Macro Add command, the Joumal window is 
automatically enlarged, and the debugger displays the macro text prompt character 
(>) indicating that you can enter the macro body. 

If the stdio screen or a user-defined screen is active when the Debugger Macro Add 
command is issued, the Journal window will not become active. Keyboard input at 
this point will be interpreted by the debugger as the macro definition. 
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The curly braces ( { } ) are required punctuation. Formal arguments can be used 
throughout the macro definition, and are later replaced by the actual arguments in 
the macro call. 

The maximum number of characters that can be entered on a line in a macro 
definition is 255. When entering macros interactively, the debugger does not 
respond to more than 78 characters on a line. When reading a command file, the 
debugger stops recognizing characters after 255 characters have been read on a line. 

The maximum number of lines allowed in a macro depends on the complexity of 
the lines. Macros with too many lines (too complex) will fail. Error 92 "Not enough 
memory for expression" will be displayed. 

A macro is similar to a C function. The body can contain any legal C statement 
(except the SWITCH and GOTO statements). The statements IF, ELSE, DO, 
WHILE, FOR, RETURN, BREAK, and CONTINUE can be used to control 
program fiow within a macro, just as in C. Macros have return types and can be 
used in expressions. 



Note Debugger commands may be used in macro definitions; they are indicated by 

placing a dollar sign ($) at the begiiming and the end of a command sequence. For 
example, the following command sequences are legal in macro definitions: 

$Program Find_Source Occurrence Forward system$; 

or 

$ 

Memory Assign Long Sitime=12 

Program Find_Source Occurrence Forward system 

$; 



Macros can be executed by specifying the macro name on the command line in a 
Debugger Macro Call command, in an expression, or with a breakpoint command. 

Macros can be removed using the command: 

Symbol Remove <macro_name> 

See Also Breakpt Access 

Breakpt Instr 
Breakpt Read 
Breakpt Write 
Debugger Macro Call 
Debugger Macro Display 
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Program Run 

Symbol Remove 

The "Using Macros and Command Files" chapter 
The "Predefined Macros" chapter in this manual. 



Example Debugger Macro Add int power (x, y) 

int x; 
int y ; 

{ 

int i; /* Loop counter */ 

int multiplier; /* Value x is multiplied by */ 

1^ Multiply x by itself y -1 times */ 
for {i = 1, multiplier = x; i < y; i++) 
X *= multiplier; 

/* Return x ^y */ 
return x; 

} 



Debugger Macro Add void stackchkO 
{ 

/* The symbols 'stack' and ' TopOf Stack' exist in the compiler's */ 

/* environment library, and are addresses which indicate the */ 

/* bottom and the top of the system stack. The symbol @sp is a */ 

/* debugger reserved symbol which contains the current value of */ 

/* the processor's stack pointer. */ 

$Expression Printf "%d bytes of stack used", TopOfStack - @sp$; 
$Expression Printf "%d bytes of stack available", @sp - stack$; 

} 
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Debugger Macro Call 



Debugger^)— Macro ^)""*{^ Co 



<macro call> <Return> 



The Debugger Macro Call command calls a macro previously defined by the 
Debugger Macro Add command or a macro built into the debugger. 



See Also Debugger Macro Add 

Debugger Macro Display 
Symbol Remove 



Example To call the previously defined macro 'stackchkQ' : 

Debugger Macro Call stackchk() 
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Debugger Macro Display 




The Debugger Macro Display command displays the source code for the named 
macro. If a window number is specified (<user_window_rmibr>), the macro source 
is written to the file or user-defined window associated with the number. If you do 
not specify a window number, the macro source is written to the Journal window. 

Macro source for built-in macros cannot be displayed. 



See Also Debugger Macro Add 

File Command 
Symbol Display 



Examples To display the source for macro ' stackchk' in user-defined window 57: 

Debugger Macro Display stackchk, 57 

To display the source for macro 'stackchk' in the Journal window: 
Debugger Macro Display stackchk 
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Debugger Option Command_Echo 



^ Debugger ^ ^—- ^ Option ^ y-» ^Command_Echo ^ — — On ^ 




OFF 




<Return> 



The Debugger Option Comniand_Echo command controls whether or not 
commands executed from a command file are echoed (copied) to the Joumal 
window. If the oFF parameter is specified, only the results (if any) of a command 
are copied to the Journal window. If the On parameter is specified, both the 
command and its results (if any) are echoed to the Joumal window. The default 
setting is On. 



Examples 



To tum OFF echo to the Joumal window of commands executed from a command 
file: 

Debugger Option Command_Echo oFF 

To tum ON echo to the Journal window of commands executed from a command 
file: 



Debugger Option Command_Echo On 
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Debugger Option Breakpts 



c 



Debugger 




Option 



X 



Breakpts 



J 





<Return> 



Enable_SW_Brks 



B3051S03 



The Debugger Option Breakpts command controls whether the software breakpoint 
capability is enabled or disabled. If software breakpoints are enabled, you can set 
Instruction breakpoints in your code using a variety of different methods supplied 
by the interface. If software breakpoints are disabled, you cannot set Instruction 
breakpoints in your code. You can still set Read, Write, and Access breakpoints 
when software breakpoints are disabled because these breakpoints are implemented 
by the analyzer hardware. 

When you disable software breakpoints, any instruction breakpoints set in your 
code are disabled, but not removed from the breakpoint table. If you re-enable 
software breakpoints, all breakpoints listed in the breakpoint window again become 
active. 



Example 



To disable software breakpoints: 



Debugger Option Breakpts Disable_SW_Brks 
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Debugger Option General 



Debugger 



Option 



Genera 



<Return> 




The Debugger Option General command changes the defauh values for the 
following debugger startup options for the current debugging session: 

Align_Bp Aligns breakpoints with processor instruction start 

Frame_Stop Controls stack walking 

Deinand_Load Enables/disables demand loading of symbols 

Radix Interprets assembly-level numbers as decimal or hex 

Step_Speed Specifies the stepping speed 

Use the Debugger Option List command to display the current option values. 

To permanently change any option default values, first use the Debugger Option 
command to change the value(s) and then use the File Startup command to save the 
new default values in a startup file. See the File Startup command for more 
information. 
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Align_Bp 

The Align_Bp option controls automatic alignment of low-level breakpoints and 
automatic alignment of disassembly. If the Align_Bp option is set to On, the 
debugger locates what it interprets as the starting address of all instructions in a 
module (by disassembling code from the beginning of the module). If you try to set 
the breakpoint at an address other than the start of an instruction, the debugger 
moves the breakpoint to the beginning of the next instruction and displays a 
warning. If you try to display memory mnemonically from an address other than 
the start of an instruction, the debugger moves the disassembly address to the 
beginning of an instruction. No Warning is displayed. If the Align_Bp option is set 
to OFF, the debugger lets you set the breakpoint at any address. The default setting 
is OFF. 



Note If multiple breakpoints exist in the same program area and Al i gn_Bp is set to 
On, their aligrmient may be incorrect. Make sure the Align_Bp option is set to 
OFF to prevent breakpoint aUgnment problems . 



Frame_Stop 

When you set the Frame_Stop option to On, if the debugger encounters a bad stack 
frame, it displays only the vaUd stack frames below the bad frame in the Backtrace 
window. When you set the Frame_Stop option to oFF, the debugger displays all 
frames, including the bad frame. The default setting is oFF. 

Demand_Load 

When the Demand_Load option is set to On, the debugger loads some symbol 
information on an as-needed, demand basis rather than during the initial loading of 
the executable (.x) file. Symbol information for global symbols, local symbols in 
the source module containing main, and local symbols in assembly modules are 
loaded during the initial load of the executable file. Local symbols in C source 
modules other than that module which contains main are loaded when the debugger 
explicitly references the module or when the program is stopped with the program 
counter set to an address in the module. Demand loading lets you load and debug 
programs that you could not otherwise load because of very large amounts of 
symbol iirformation. The default setting for Demand_Load is oFF. 

There are several side effects of demand loading. The debugger command Memory 
Unload_BBA is disabled. Type mismatch errors may not be detected during the 
initial load of the executable (.x) file. Global symbols may have leading 
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underscores stripped, depending on whether they were defined or referenced in a C 
or assembly source module. 

Radix 

The radix option causes the debugger to interpret numeric literals, including 
integers and addresses, as either decimal or hexadecimal values. By default, 
numeric literals are interpreted as decimal values. 

If you set Radix to hexadecimal, any number you want interpreted as decimal 
must be terminated with a T (for example, specify 32 as 32T). 

Even if you select Hex, the following inputs wiU not be interpreted as hexadecimal: 
line numbers starting with "#", variables in high-level expressions, and debugger 
variables including breakpoint numbers, viewport numbers, and data viewport line 
numbers. To cast a high-level expression as hexadecimal, use a leading "Ox" or a 
trailing "h". 

Binary numbers are not available when Radix is set to hexadecimal. Floating 
point and enumeration type values are not affected by the radix option. 

The Output parameter lets you specify whether the output of the Expression 
Display _Value, Expression Monitor Value, and Program Context Expand 
command is displayed in decimal or hexadecimal format. 

Step Speed 

The Step_Speed option specifies the stepping speed. The stepping speed can be in 
the range of 0 to 100 units. Higher numbers represent slower speeds. This option 
affects the Program Step command. The default value is 0. 

See Also File Startup 

Debugger Option List 



Example To aUgn assembly-level breakpoints at the begiiming of an instruction: 

Debugger Option General Align_Bp On 
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Debugger Option List 



Debugger 



Option 



List 



<Return> 



The Debugger Option List command lists the current debugger option values in the 
Journal window. The list wiU be similar to the sample Ust shown in the example. 



See Also Debugger Option Command_Echo 

Debugger Option General 
Debugger Option Symbolics 
Debugger Option View 
Settings^Debugger Options ... 



Examples To list the current debugger option settings in the Joumal window: 

Debugger Option List 
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Debugger Option Symbolics 



Debugger^)— -(^Option ^^)— -(^Symbolics ^ 



Assem_Symbols V- 

Intermixed 

ChGck_Args )- 
Uppercase_Mods 

Line_Option 
Symbol_Case 




On 



OFF 



— <option numbers 



Sensitive_Only 



Lower 



Upper 



All 



<Return> 



E3490B10 



The Debugger Option Symbolics command changes tiie default values for tiie 
following debugger symbol options and C source line display options for the 
current debugging session: 



Assem_Symbols 

Intermixed 

Check_Args 

Uppercase_Mods 

Line_Option 

Symbol_Case 



Displays symbols in assembly code 

Intermixes C source with assembly code 

Enables parameter checking in commands and macros 

Converts module names to upper case 

Sets options for building line numbers 

Controls case-sensitivity of symbol lookups 
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Use the Debugger Option List command to display the current option values. 

To permanently change any option default values, first use the Debugger Option 
command to change the value(s) and then use the File Startup command to save the 
new default values in a startup file. See the File Startup command for more 
information. 

AssemSymbols 

The Assem_Symbols option causes symbols instead of memory addresses to be 
displayed in the disassembled code whenever possible. Symbol names are placed to 
the right of the disassembled code for immediate values. This is done because there 
is no sure way of telling if the immediate value was represented by the symbol at 
assembly time. This option is set to On by default. 

Intermixed 

The Intermixed option intermixes C source code with the assembly code generated 
for each respective C statement. This option is off by default. 

Check_Args 

The Check_Args option controls parameter checking in commands and macros. If 
oFF is selected, the debugger does not do any argument checking. If On is 
selected, the debugger wams you when an assignment is made which contains a C 
type mismatch. This option is off by default. 

Uppercase_Mods 

The Uppercase_Mods option tells the debugger to convert module names to all 
uppercase before entering them in the database. This is useful if you have module 
names that are the same name as functions (for example, module 'main' contains 
function 'main'), because the debugger often scopes modules at a higher level than 
functions. 

Line_Option 

The Line_Option defines options for building line numbers from the absolute file. 
The only option currently defined is set using bit 0 of the number. It is set to 1 to 
not strech a section if the hue address is outside the range of the enclosing section. 
This currently applies to the OMF86 reader only. 
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Symbol_Case 

SymboLCase tells the debugger how to look up symbols. The debugger will 
always look up the symbol as entered, case sensitive. This option allows you to 
specify that if the case sensitive lookup fails, the debugger should try again after 
converting the symbol to all uppercase (Upper), lowercase (Lower), or upper first 
and then lower (All). This option is useful if your toolset converts symbols to all 
uppercase or lowercase characters. 

See Also File Startup 



Examples To display symbol names instead of address values in disassembled code: 

Debugger Option Symbolics Assem_Symbols On 

To tum OFF display of C source lines in assembly-level Code window: 
Debugger Option Symbolics Intermixed oFF 

To enable debugger expression parameter checking: 
Debugger Option Symbolics Check:_Args On 
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Debugger Option Trace 



(^Debugger ^^)-*-(^ Option 



Trace 



^--»{^e1ch_Align 



Coun 



t JKt — Nothing \ 



Depth 




Time 



Byte 



Word 



Long 



<number> 



<Reiurn> 



B3051S08 



The Debugger Option Trace command changes the default behavior of bus-level 
tracing. 

Count 

If Count is Nothing, all of the trace memory will be used to store bus states. 

If Count is Time, half of the trace memory will be used to store timing information. 



Note 



If you are using the 64794A - Deep Emulation Analyzer, all memory will always 
be used to store bus states regardless of the Count setting. 



The debugger interface does not display timing information. Use the 
emulator/analyzer interface to display timing. 

FetchAlign 

The Fetch_Ahgn option allows you to trigger a frace on an instruction's address 
which never appears on the bus. For example, this might happen when an 
instruction for a processor with a 32-bit bus lies between longword boundaries. 
The Fetch_Ahgn operation masks address values so that they appear to occur on 
the boundaries appropriate for the processor's bus width. 
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Depth 

Sets the number of states available for display. This option only applies if you have 
the 64794A Deep Emulation Analyzer. The number of states actually stored is a 
configuration item; this option only controls the number of states uploaded to the 
interface. To improve performance, set this number to a small initial value (1024) 
and then increase it when you need to see more states. The measurement does not 
need to be run again — changing the depth will cause more states to be displayed. 

Defaults are Count Time and Fetch_Align Word. 
See Also Information about "equivalent addresses" in your analyzer manual. 
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Debugger Option View 




The Debugger Option View command changes the default values for the following 
debugger display options for the current debugging session: 

Breakpt_Window 
View_Window 
Highlight 
More 

Stdio_Window 
Amt_Scroll 

Use the Debugger Option List command to display the current option values. 

To permanently change any of the default values, first use the appropriate 
Debugger Option command to change the value(s) and then use the File Startup 
command to save the new default values in a startup file. See the File Startup 
command for more information. 
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Breal(pt_Window 

The Breakpt_Window option controls the display of the breakpoint window. 

The On setting causes the Breakpoint window to be displayed at all times. The 
window may be hidden by other windows but will be displayed whenever a 
breakpoint is set or deleted. 

If you specify the Swap setting, the window is not automatically displayed. You 
must set or delete a breakpoint or enter the Window Active Breakpoint command 
to display the window. The default setting is Swap. 

ViewWindow 

The View_Window option controls the display of the view window. 

The On setting causes the View window to be displayed at all times. The window 
may be hidden by other windows but wiU be displayed whenever a Debugger 
Execution Display_Status command is executed. 

If you specify the Swap setting, the window is not automatically displayed. You 
must enter the Debugger Execution Display_Status command or the Window 
Active View command to display the window. The default setting is Swap. 

Higliliglit 

The Highhght option determines whether highlighted information in debugger 
windows is displayed in half-bright video or inverse video. The default is Inverse. 

More 

The More option controls how information resulting from a debugger command is 
listed to the Journal window. 

If the More option is On, information is listed one screen at a time in the Journal 
window, in the same way as the more command in the Unix operating system 
works. 

If the More option is oFF, all information resulting from a debugger command is 
written to the display at once, making it difficult to view information greater than 
the number of Unes available in the Joumal window. The default setting is On. 
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Stdio_Window 

The Stdio_Window option controls the display of the Stdio window. 

The Swap setting causes the Stdio window to be displayed when a program writes 
to it and to be removed when the program returns to the command mode. 

The On setting causes the Stdio window to be displayed at all times. The window 
may be hidden by other windows but will be displayed when a program is writing 
to it. 

If the oFF setting is selected, the window is not automatically displayed. You must 
press function key F6 or enter the command Window Screen_On Stdio to 
display the window. 

The default setting is Swap. 
Amt_Scroll 

The Amt_Scroll option controls the amount that the Journal and Stdio windows are 
scrolled when written to. When the output reaches the bottom of the window, the 
data scrolls up one Une by default. You can specify a number of lines from one to 
50. 



Examples To set the Swap option so that the Breakpoint window is displayed only when the 

Window Active Breakpoint command is executed: 

Debugger Option View Break:pt_Window Swap 

To set the View_Window option so that the view window is always displayed: 
Debugger Option View View_Window On 
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Debugger Pause 




< Return> 



The Debugger Pause Time command pauses the debugger for the specified number 
of seconds or (if you enter the Debugger Pause command without the Time 
parameter) pauses the debugger until you press the space bar, 
CTRL C, or the escape key (Esc) twice. The Debugger Pause command is useful 
when executing command files. 

See Also File Command 

Examples To pause the debugger for ten seconds: 

Debugger Pause Time 10 

To pause the debugger until the space bar, CTRL C, or Esc-Esc is pressed: 
Debugger Pause 
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Debugger Quit 



Debugger 



Quit 



Yes 



<Return> 



Locked 



Released 



The Debugger Quit command ends a debugging session without saving the session. 
If you enter the command Debugger Qui t Yes, the debugging session is 
immediately ended. 

The Debugger Quit command does not save the debugging session. Use the File 
Startup command to save the current set of debugger startup options and window 
parameters in a startup file. 

Yes Option 

The Yes option terminates only this interface to the emulator. If this is the only 
interface using the emulator, the emulator will be left locked. 

Loclced Option 

The Locked option lets you lock the emulation hardware (and a connected target 
system) so that other users cannot access the hardware until it is explicitly released. 

This option will cause aU interfaces coimected to the emulator to discoimect. 
Released Option 

The Released option releases the emulation hardware to other users on the host 
computer system. 

This option wiU cause all interfaces connected to the emulator to disconnect. 



See Also 



Debugger Host_Shell 



Examples 



To terminate the debugging session immediately: 
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Debugger Quit Yes 

To terminate the debugging session and release the emulator hardware so that other 
users can access it: 

Debugger Quit Released 

To terminate the debugging session and lock the emulator hardware so that other 
users cannot access it: 

Debugger Quit Locked 
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Expression C_Expression 



(^Expression^ -(^C_ Expression^ <C_expr> 



<Return> 



The Expression C_Expression command calculates the value of most vaUd C 
expressions or assigns a value to a variable. The result is displayed in floating point 
or in decimal, hexadecimal, and ASCII formats. 

The Expression C_Expression command can be used to set C variables by 
specifying a C assignment statement. This command recognizes variable types, and 
the assigimient expressions specified behave according to the rules of C. 



Note The Expression C_Expression command cannot evaluate conditionals of the form: 

<expression>?<expression> : <expression> 



Examples To calculate the value of 'time' and display the result "data address 000091DC 

{time_struct}": 

Expression C_Expression time 

To calculate the value of member 'hours' of structure 'time' and display the result 

"4 0x04": 

Expression C_Expression time->hours 

To assign the value 1 to 'system_is_running' and display the result "1 0x01": 
Expression C_Expression system_is_running = 1 
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Expression Display_Value 



( ^Expression J)— °-( ^Display_Value ^ 





<expr> 




<Return> 







.<expr> 



The Expression Display_Value command displays expressions and their values in 
the Journal window. AU expressions displayed with this command are displayed 
according to their type as shown in the following hst: 



Type 



Display Format 



Ints 
Longs 
Shorts 
Chars 

Pointers 
Enums 

Arrays 

Structures 

Quoted String 

Hex Byte 

Hex Word 

Hex Double Word 

Float 

Double 



32-bit signed decimal numbers 

32-bit signed decimal numbers 

16-bit signed decimal numbers 

8-bit characters (unsigned hexadecimal numbers if not 

printable) 

32-bit unsigned numbers 

Name of Enumerator constant (enumerator value if name 
not defined) 
All elements 
All members 

All characters as typed, in by double quotes (" ") 

8-bit hexadecimal 

16-bit hexadecimal 

32-bit hexadecimal 

32-bit floating point 

64-bit floating point 



Note 



The contents of an item such as an array is displayed instead of the C value of the 
item, which is its address. 
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If an expression range is displayed, each value within the range is displayed 

according to the base type (if one exists). For example, if the variable /Za^,? is a 
character array, the following command results in elements flags [10] through 
flags [30] being displayed: 

Expression Display_Value f lags+10 . . +30 

Note that the command first evaluates flags [10] to a character, and uses this as 
the base of the address range. Flags [30] is also evaluated to a character. It is 
used as the end of the address range. 

Any expression can be type cast to display it in a different format. All values that 
make up a complex type are printed. For example, if the variable count is a long, 
the following statement displays it as a four-character array: 

Expression Display_Value (char [4] ) &count 

To display the contents of a character array as a string, cast the variable using the 
quoted string cast, as shown in the following example: 

Expression Display_Value (Q S)buf 

If the type of the expression is unknown, it defaults to type byte. See the 
"Expressions and Symbols in Debugger Commands" chapter for more information 
about type casting. 

See Also Expression Fprintf 

Expression Monitor Value 
Expression Printf 
Memory Display 



Examples To display the value of the variable ' system_is_running' : Olh 

Expression Display_Value system_is_running 

To display the address of the variable 'system_is_running': 00009 IFO 
Expression Display_Value &system_is_running 

To display the address of the C structure 'time': 000091DC 
Expression Display_Value time 
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To display the values of the members of structure 'time': 
hours 4 
minutes 0 
seconds 20 

Expression Display_Value *time 

To display the name of the current program module: 

Expression DisplaY_Value @module 

To display the name of the current program function: 
Expression DisplaY_Value Sfunction 
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Expression Fprintf 



(^Expression^^— Fprintf "^^-^ <window_nmbr> 



,"<format strlng>" 




<Return> 





,<argument> 



The Expression Fprintf command prints formatted output to the specified 
user-defined window. Formatted output may be written to a file that has been 
opened by the File User_Fopen command. The Expression Fprintf command is 
similar to the C fprintf function. 

This command allows type conversions, scaling, and positioning of output in a file 
or in a window. The window number must have been previously assigned by a File 
User_Fopen or Window New command or the window number must be the log file 
number (28) or journal file number (29), if opened. 

The command requires a format string as the second parameter. The format string 
may contain both text and argument conversion specifications. Whenever a 
conversion specification is encountered, the next argument is converted according 
to the specification, and the result is copied to the output window. 

The conversion specifiers are similar to those in C and have the following format; 

%[-] [digits] [.[digits]] [1] conversion_char 

where: 

% indicates the start of a conversion specification. 

indicates that the result of conversion is to be left-justified 
within the field. 
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digits is a string of one or more decimal characters. The first digits is 

a minimum field width. The field will be at least this many 
characters wide, padded if necessary. The padding is normally 
on the left. When '-' is used, padding is on the right. The field 
is padded with blanks unless the first digit in digits is a 0; then 
the field is padded with zeros. 

separates two digit strings and must be specified if a second 
digit string is used. 

digits (second occurrence) is the maximum field width. For strings, it 

is the maximum number of characters to print; for f and e 
notations, it is the maximum number of fractional decimal 
places to print. For g notation, it is the number of significant 
digits to be printed. 

1 indicates that a conversion character (d, x, or u) corresponds to 

a long argument. 

Conversion Cliaracters 

Conversion characters are listed in the following table with a detailed description 
of each character. 

Char Description 

c The argument is converted to character format. 

d The argument is converted to decimal format. 

e, E The float or double argument is converted to the format 

[ - ] d . ddde+dd, where the number of digits after the decimal 
point is equal to the precision. If precision is zero, no decimal 
point is printed. The default precision is 6. The E conversion 
character produces a number with E instead of e introducing the 
exponent. The exponent always contains at least two digits. 

f The double argument is converted to decimal notation in the 

format [ - ] ddd . ddd, where the number of digits after the 
decimal point is equal to the precision specification. If the 
precision is not specified, it is 6 by default; if the precision is 
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explicitly zero, no decimal point appears. If there is a decimal 
point, at least one digit appears before it. 

g, G The double argument is printed in f or e notation, or in F or E 

notation when G is used. The precision specifies the number of 
significant digits. The notation used depends on the value 
converted; e or E notation will be used only if the exponent 
resulting from the conversion is less than -3 or greater than or 
equal to the precision. Trailing zeros are removed from the 
result; a decimal point appears only if it is followed by a digit. 

h The argument is either the debugger internal variable @HLPC, 

or a high level Une number preceded by the # character. Source 
lines are formatted as strings according to %s rules. (Note: See 
@HLPC in the "Registers" chapter of this manual.) 

m The argument is an instruction address. The disassembled 

instruction is treated as a string. 

s The argument is a string. The characters from the string are 

copied to the output until a NULL character is encountered or 
the maximum number of characters specified have been printed. 

u The argument is converted to unsigned decimal format. 

V The argument is displayed according to its type. 

w The argument is is a window number. The current contents of 

the window are written to the specified window. 

X The argument is converted to hexadecimal. Letters are 

displayed in upper case. Ox is not printed before the value. 

X The argument is converted to hexadecimal. Letters are 

displayed in lower case. 

% The character % is substituted for the field. Any other 

non-conversion character following a % is printed. %% is used 
to generate % in the output as a literal character. 

Conversion characters are case-sensitive. Values printed in E notation have the 
following format: 
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[-]d.d. . .E{+|-}dd 

Each d represents a decimal digit. The number is first scaled so that one digit 
appears to the left of the decimal point. The number of digits in the fractional part 
is six by default, or the maximum field width if specified. The sign of the mantissa 
is printed only if the number is negative. The sign of the exponent is always printed. 

Values printed in F notation have the following format: 

[-] d. . . . d. . . 

Each d represents a decimal digit. The number of digits in the fractional part is six 
by default or the maximum field width if specified. The number of digits printed 
depends on the number of significant digits in the number. 

Because floating point values are passed as parameters, they are converted to 
double precision. Parameters must be promoted to double precision values as a 
requirement of the C language. Other values passed as parameters may also be 
converted. 

The Expression Fprintf command uses the format string to decide how many 
arguments to print. The number of conversion specifications must equal the 
number of arguments. If there are too many arguments, some of them will not be 
printed. If there are too few arguments, the value printed cannot be determined. 

If the argument type does not correspond to its conversion field specification, 
arguments may be converted incorrectly. 

See the Expression Printf command for details about conversion specifiers. 

See Also Expression Printf 

File Journal 
File Log 
File User_Fopen 
Window New 



Examples To print value of 'var' to user window 57 as a single character: 

Expression Fprintf 57,"%c",var 

To print the string in double quotes to user window 57 followed by the floating 
point value of 'temperature' with a precision of 2: 
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Expression Fprintf 57, "The value of 'temperature' is: 
%.2f \n" , temperature 

To print source line 24 to user window 55: 
Expression Fprintf 55,"%h",#24 

To print the contents of the assembly-level stack window to user window 256: 
Expression Fprintf 256,"%w",14 
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Expression Monitor Ciear_AII 



Expression^) -(^ Monitor j »-(^CIear_AII j- 



<Return> 



The Expression Monitor Clear_All command stops monitoring of all expressions 
being monitored with the Expression Monitor Value command and removes aU 
expressions from the Monitor window. 



See Also Expression Fprintf 

Expression Monitor Delete 
Expression Monitor Value 
Expression Printf 
Memory Display 



Examples To stop monitoring aU expressions: 

Expression Monitor Clear_All 
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Expression Monitor Deiete 



(^Expression^)— »-(^ Monitor Delete 





<display nmbr> 




<Return> 







..<display_nmbr> 



The Expression Monitor Delete command stops monitoring of specified 
expressions being monitored with the Expression Monitor Value command and 
removes those expressions from the Monitor window. 

When an expression is monitored using the Expression Monitor Value command, it 
is assigned a line number, which is displayed in the Monitor window. These 
assigned line numbers are used to specify the expression or group of expressions to 
be deleted (removed). All monitored expressions can be deleted with the 
Expression Monitor Clear_All command. 

See Also Expression Fprintf 

Expression Monitor Clear_All 
Expression Monitor Value 
Expression Printf 
Memory Display 



Examples To stop monitoring expression 2 in the Monitor window: 

Expression Monitor Delete 2 

To stop monitoring expressions 3 through 6 in the Monitor window: 
Expression Monitor Delete 3.. 6 
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Expression Monitor Vaiue 



( ^Expression^ ^^)— -( ^ Monitor ^ ^~~* ^ Value ^ 



<expr> 



..<expr> 



0 



;<display_nmbr> 



..<display_nmbr> 



<Return> 



The Expression Monitor Value command monitors the specified expressions as the 
target program is executing. Expressions are updated and displayed in the Monitor 
window each time the debugger stops executing the program. 

Up to seventeen lines, selected by the display line range parameter 
(;<display_nmbr>..<display_nmbr>), can be displayed in the Monitor window. 

Variables located in registers are shown with a ? between their names and values. 
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All expressions monitored with this command are displayed according to their type 
as follows: 



Type Display Format 

Ints 32-bit signed decimal numbers 

Longs 32-bit signed decimal numbers 

Shorts 16-bit signed decimal numbers 

Chars 8 bit characters (unsigned hexadecimal numbers if not 
printable) 

Pointers 32-bit unsigned numbers 

Enums Name of Enumerator constant (enumerator value if name 
not defined) 

Arrays All elements if enough lines, else first element 

Structures All members if enough Unes, else first element 

Quoted String Characters surrounded by double quotes (" ") 

Hex Byte 8-bit hexadecimal 

Hex Word 16-bit hexadecimal 

Hex Double Word 32-bit hexadecimal 

Float 32-bit floating point 

Double 64-bit floating point 



If an expression range is displayed, each value within the range is displayed 
according to the base type (if one exists). For example, if the Ysdable flags is a 
character array, the following command displays 20 characters. 

Expression Monitor Value f lags+10 . . +29 

Any expression can be type cast to display its value in a different format. For 
example, if the variable count is a long value, the following statement causes count 
to be displayed as a four character array: 

Expression Monitor Value (char [ 4 ] ) Scount 
If the type of the expression is unknown, it defaults to type byte. 

Only 17 lines can be displayed in the data window. By default, a single line is used 
to display monitored expressions. If an array is monitored, only the elements that 
win fit on one Une will be displayed. If a structure is monitored, only the first 
member will be displayed. To display an entire array or structure, a display line 
range may have to be specified. If all hues in the data window are filled, you must 
use the Expression Monitor Delete command to delete an expression before 
monitoring another one. 
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If you do not specify a display line range, the next available line in the data 

window is selected to display the monitored variable. If you specify one line, the 
expression is displayed on that line. If you specify a range of lines, the amount of 
data that will fit on those lines is displayed. 

See Also Expression Monitor Clear_All 

Expression Monitor Delete 
Symbol Display 



Examples To monitor the value of variable ' current_temp' : 

Expression Monitor Value current_temp 

To monitor the value of the three members in structure 'time' and display them on 
Monitor window lines 4 through 6: 

Expression Monitor Value *tiine;4..6 

To monitor the contents of string buf: 

Expression Monitor Value (Q S)buf 
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Expression Printf 



(^Expression^)— Printf 



"<formQt string>" 




<Return> 

















,<argument> 



The Expression Printf command prints formatted output to the Journal window. 
See the Expression Fprintf command for a detailed description. 



See Also 



Expression Fprintf 
File User_Fopen 



Examples 



To print the string in double quotes to the journal window followed by the floating 
point value of 'temperature' with a precision of 2: 

Expression Printf "The value of 'temperature' is: %.2f 
\n" , temperature 

To print source line 24 to the Joumal window: 
Expression Printf "%h",#24 

To print the name of the current module to the Journal window: 
Expression Printf " %s " , @module 

To print the disassembled instruction at address 2030h to the Joumal window as a 
string: 



Expression Printf 



2030h 



00002030 2040 MOVEA.L DO, AO 

To print the contents of the assembly-level stack window to the Joumal window: 
Expression Printf "%w",14 
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File Command 

File ^ ■^Command ^ 





<file name> 




<Return> 


) — ' 





The File Command command reads the file specified by <file_name> and executes 
the commands contained in the file as though they were entered from the keyboard. 
Commands in the file are executed until the end of the file is reached. Input then 
continues from the previous source. The previous source can be the keyboard or 
another command file. 

This command is commonly used to read macro definitions from a file, to set up 
I/O ports, or to change window displays. 

File Command commands may be nested up to 16 levels deep. 

If the filename consists of alphanumeric characters, a period, or a backslash, double 
quotation marks are optional. Otherwise, quotation marks must enclose the file 
name. If a filename extension is not specified, the debugger automatically appends 
a default extension, .com. 

Command files can be executed at debugger startup using the -c option, from the 
command line during a debugging session, or from a startup file. 

See the File Startup command description for information about how to 
automatically execute a command file when the debugger is started. 



See Also File Log 

File Startup 

The "Using Macros and Command FUes" chapter. 



Example To execute command file 'varTrace.com' : 

File Command varTrace 
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File Error Command 



File 



Error Command 



Abort Read 



Continue Read 



Quit_Debugger 



<Return> 



The File Error_Command command sets the command file error handling mode. 
The command specifies what action the debugger takes when an error occurs while 
reading a command file. Abort _Read causes the debugger to return to the command 
line after an error and wait for keyboard input. This is the default action. 
Continue _Read causes the debugger to continue to the next command in the 
command file after an error. Quit_Debugger causes the debugger to end the 
debugging session when an error occurs (as if you typed Debugger Quit Yes). 



See Also File Command 

File Log 



Examples To return to the command line after an error and wait for keyboard input: 

File Error_Command Abort_Read 

To continue to the next command in the command file after an error: 
File Error_Conimand Continue_Read 

To exit the debugger when an error occurs: 
File Error_Coininand Quit_Debugger 
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File Journal 



Rls JournQl \- 



On 



Append 




OFF 



Browse 



> 



<f ile_nDme> 




<Return> 





Start 



Restart 



End 



NexINCmds 



> 



The File Journal command copies the information written to the Journal window 
output into a journal file specified by <file_name>. The default journal filename 
extension .jou will be appended to <filename>. The journal file provides a history 
of your debugging session. 

File Journal On opens a journal file for writing. If a file already exists with 
the specified file name, new information is appended to the end of the existing file. 

File Journal Append opens an existing file. New information is appended 
to the end of the existing fUe. 

File Journal oFF closes the journal file. 

File Journal Brop\rse opens a journal browser window in the graphical 
interface. Start opens a new browser window. End stops output to the current 
browser without closing the window. Restart has the same effect as Start followed 
by End. NextNCmds causes the output from the nextn commands to be sent to an 
individual browser. 

A window number (29) is assigned to the journal file so that output can be written 
to that file using the Expression Fprintf command. 



See Also 



Expression Fprintf "To view commands in a separate window" on page 132. 
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Examples To make and open journal file 'debugl .jou' for writing: 

File Journal On debugl 

To close the currenfly open journal file: 
File Journal oFF 

To open existing journal file 'debugl jou' for writing and append new information 
at the end of the file: 

File Journal Append debugl 
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File Log 

( File )-*( Log 






<file name> 




<Return> 




/ ■ 



<comment text> 



The File Log command records user input in a command file, specified by 
<file_name>. The default filename extension .com will be appended to <filename>. 
The File Log command allows an interactive debugger session to be logged as a 
command file which can be rerun at a later time. 

File Log On opens a file for writing. If the specified file already exists, the file 
is overwritten by the new data. 

File Log Append reopens a logging file to allow new information to be added 
to the end of the file. 

File Log oFF terminates logging to the file. 

File Log Commen t places a string of text in the file as a comment. If a log file 
is not open, File Log Comment commands are ignored by the debugger. 

All successful commands are written to the log file so the file can later be used as a 
command file. 

Commands which are entered but not successfully completed, are written to the 
.com file as comments along with their error codes. 

User input is recorded in the log file until the Log oFF command is executed. 

A window number (28) is assigned to the log file so that output can be written to 
that tile using the Expression Fprintf command. 



See Also 



Expression Fprintf 
File Error Command 
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Examples To make and open log file 'logl .com' for writing: 

File Log On logl 

To close the currently open log file: 
File Log oFF 

To open existing log file Togl.com' for writing and append new information at the 
end of the file: 

File Log Append logl 

To place the comment 'This is a comment string' in the log file: 
File Log Comment This is a comment string. 

If a log file is not open, this command is ignored. 
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File Startup 




<Return> 



The File Startup command saves the current debugger option settings and window 
parameters in a startup file specified by <startup_file>. When you start a debugging 
session and specify the startup file with the -s option of the db68k command, the 
startup options and window parameters you saved will be the default parameters in 
that debugging session. 

A startup file has an extension of .rc appended to the end of it. If you do not specify 
a startup file name, the startup options are saved in a file named db68k.rc. 

You can modify default debugger startup option values with the Debugger Option 
command and window parameters with the Window commands. 

Remember that you can also specify a command file to be executed when the 
debugger starts. 

See Also Debugger Option 

File Command 
Window New 
Window Resize 

the "Using Macros and Command FUes" chapter 



Examples To save the current set of debugger startup options and window parameters in 

startup file 'my_start_file.rc': 

File Startup iny_start_f ile 
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To save the current set of debugger startup options and window parameters in 
startup file 'my_start_file.rc' and execute the command file 'initDemo.com' 
whenever the debugger is started using 'my_start_file.rc' : 

File Startup my_start_f ile , initDemo 
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File ^ ^)— »-( ^User_Fopen ^ — — * ^ Append J — ^ <window_nmbr> 




Create 



Read 



<Tab> 



File 





<file name> 




<Return> 







The File User_Fopen command opens the file specified by <file_name> for reading 
or writing and assigns a window number to it. 

The File User_Fopen Appendcommand opens an existing file for writing, 
adding new information at the end of the fUe. 

The File User_Fopen Crea t e command creates a new file for writing. 

The File User_Fopen Read command opens an existing file for reading. 

After opening a file using the File User_Fopen Append or File User_Fopen Create 
command, you can use the Expression Fprintf command to write information to the 
file. Files opened for reading may be read from the built-in macro fgetc(). See the 
"Predefined Macros" chapter of this manual for a complete description of this 
macro. 

The window number must be between 50 and 256 inclusive. 

Use the Window Delete or the File Window Close command to close the file. 



See Also 



Expression Fprintf 
File Window_Close 
Window Delete 
Window New 
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Examples To open user window 57 and redirect any data written to window 57 to the file 

'varTrace.out': 

File User_Fopen Create 57 File varTrace.out 

To open user window 57 and append any data written to window 57 to the existing 
file 'varTrace.out': 

File User_Fopen Append 57 File varTrace.out 

To open file 'temp.dat' for reading, accessing the file as user window 52: 
File User_Fopen Read 52 File temp.dat 
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File Window Close 



File 



Window Close ) " <file window num> " <Return> 



The File Wmdow_Close command closes a device or file which was previously 
opened with the File User_Fopen command. The Window Delete command may 
also be used for this purpose. 

See Also File User_Fopen 

Window Delete 



Example To close file associated with user window number 57: 

File Window_Close 57 
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Memory Assign 




Note Debugger/emulators cannot modify memory locations in target ROM 



The Memory Assign command changes the contents of the memory location 
specified by <addr> to the value or values defined by the expression <expr> or 
expression string <expr_string>. The size of the memory elements to be modified 
is specified by one of the size qualifiers (Byte, Word, or Long). 

Expression strings are specified as ASCII characters enclosed in quotation marks 
and/or as a list of values separated by commas. Expressions and expression string 
elements will be truncated or padded as required, based on the size qualifier. 

Memory values can be entered interactively if you do not define a value on the 
command line. When a value is not specified, the contents of the specified memory 
locations are displayed in hexadecimal and decimal. You can change the existing 
value by entering any legal expression followed by a carriage return. The next 
memory location and its contents are then displayed. The return key entered 
without a value will cause the command to terminate. 

The Memory Assign command does not recognize variable typing. It is intended to 
be used as an assembly-level memory setting routine. For example, assume that the 
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variable count is a long integer. If you want to set the value of count equal to 5, the 
command 

Memory Assign Long count=5 

win not work. The command will set the memory location referenced by the value 
of count equal to 5, not the contents of the variable. To set the value of count equal 
to 5, use the following command: 

Memory Assign Long &count=5 

The Expression C_Expression command should be used to set C variables. This 
command recognizes variable types and the specified expressions behave 
according to the rules of C. The command: 

Expression C_Expression count=5 
win set count equal to 5. 

See Also Expression C_Expression 

Memory Register 



Examples To display the contents of memory location lOOOh and allow interactive 

modification of memory contents: 
00001000 = 0x48 72: 

Memory Assign Byte lOOOh 

To change the contents of memory locations 2000h through 2005h to 00, 41, 00, 
42, 00, 43, and change the contents of locations 2006h/2007h to the value of 

' system_is_running' : 

Memory Assign Word 2000h=41h, 42h, 43h, system_is_running 
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Memory Block_Operation Copy 



Memory ^ ^y-» ^BIock_Operoiiori^ ^— Copy » <cddr>..<oddr> 




<addr> 




<Return> 





Note 



Debugger/emulators cannot copy to memory locations in target ROM. 



The Memory Block_Operation Copy command copies the contents of the memory 
range specified by <addr>..<addr> to a block of the same size starting at the 
memory location specified by <addr>. 



See Also 



Memory Assign 
Memory Block_Operation Fill 
Memory Block_Operation Match 
Memory Block_Operation Search 
Memory Block_Operation Test 



Examples 



To copy the block of memory starting at address lOOOh and ending at address lOffh 
to a block of the same size starting at address 5000h: 

Memory Block_Operation Copy lOOOh . . lOf fh, 5000h 

To copy the block of memory starting at the address of the structure 
'current_targets' and ending 15 bytes after this address to a block of memory 
starting at the address of the structure 'default_targets': 



Memory Block_Operation Copy &current_targets . . +Oxf , 
&def ault_targets 
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Memory Block_Operation Fill 



^ MemoryJ-»^lock_Operation ^^)->^ Fill ^ — — Byte ^ 



Word 



Long 



<addr>..<addr> 




<Return> 







<expr> 









<expr_string> 



Note 



Debugger/emulators cannot fill memory locations in target ROM. 



The Memory Block_Operation Fill command fills the range of memory locations 
specified by the address range <addr>.. <addr> with the value or values specified 
by an expression <expr> or an expression string <expr_string>. If no expression is 
given, the debugger fills the specified memory locations with zeros. The speciiied 
size quaUfier (Byte, Word, or Long) determines the size of the value. 

If you specify a single expression value, the debugger fills the memory area with 
that value. If you enter an expression string, the debugger fills the memory area 
with the specified string pattern. 

An expression string is a hst of values separated by commas and can include ASCII 
characters enclosed in quotation marks. AU expressions in an expression string are 
padded or truncated to the size specified by the size qualifiers if they do not fit the 

specified size evenly. 

If the number of values in an expression string is less than the number of bytes in 
the specified address range, the debugger repeatedly places the list of values in 
memory until all designated memory locations are filled. If you specify more 
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values than can be contained in the specified address range, the debugger ignores 
the excess values. 

See Also Memory Assign 

Memory Block_Operation Copy 
Memory Block_Operation Match 
Memory Block_Operation Search 
Memory Block_Operation Test 
Memory Register 

Examples To fill memory locations lOOOh through 1007h with the long pattern 61626364, 

65666768: 

Memory Block_Operation Fill Long 0x1000 .. +7=' abcdefgh' 

To fill the memory area starting at location lOOOh and ending at location lOffh with 

zeros: 

Memory Block_Operation Fill Byte 0x1000 .. OxlOff 
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Memory Block_Operation Match 



^ Memory J -> ^ Block_Operotion Match J — ^ — ' ^Repeoi_On_Misinotch ) 




Stop _ On _ Mismatch 




<addr>..<aclclr> 



<Return> 



<Qddr> 



The Memory Block_Operation Match command compares the contents of two 
blocks of memory to determine their similarities or differences. The command 
compares the block of memory specified by the address range <addr>.. <addr> 
with the same size block starting at <addr>. 

The debugger displays differences between the two blocks of memory, mismatched 
values and addresses, in the Journal window. If the contents of the two blocks of 
memory are the same, the debugger displays the message Memory blocks are the 
same. 

The Memory Block_Operation Match Stop_On_Mismatch command halts when a 
mismatch is found. If the Memory Block_Operation Match Repeat_On_Mismatch 
command is selected, the comparison continues until the end of the block. 

When you execute the Memory Block_Operation Match 
Stop_On_Mismatch/Repeat_On_Mismatch command without specifying an 
address range, the debugger continues comparing the address range specified in 
the previous Memory Block_Operation Match Stop_On_Mismatch command 
starting from where it found the last mismatch. 



See Also Memory Block_Operation Copy 

Memory Block_Operation Fill 
Memory Block_Operation Search 
Memory Block_Operation Test 
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Examples To compare the block of memory starting at address lOOOh and ending at address 

lOffh with a block of the same size beginning at address 5000h and stop when a 
difference is found: 

Memory Block_Operation Match Stop_On_Mismatch 
lOOOh. .10ffh,5000h 

To execute the previous Memory Block_Operation Match Stop_On_Mismatch 
command starting from where it found the last mismatch: 

Memory Block_Operation Match Stop_On_Mismatch 

To compare the block of memory starting at address lOOOh and ending at address 
lOffh with a block of the same size beginning at address 5000h and stop at the end 
of the memory block: 

Memory Block._Operation Match Repeat_On_Mismatch 
lOOOh. .10ffh,5000h 
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Memory Block_Operation Search 



IVlemory"^ ^)-« ^BIock_Operotion ^ ^^-" ^ Seorch^ ^^-^ — » ^ Byte ^ — y 

Word~^ 



^--*(^ Long 




<addr>..<addr> 




<expr> 



<expr_string> 



<Return> 



The Memory Block_Operation Search command searches the block of memory 
specified by <addr> ..<addr> for the specified expression <expr> or expression 
sirmg<e)q)r_string>. The size qualifier (Byte, Word, or Long) specifies the size of 
an expression or each expression in an expression string. A Memory 
Block_Operation Search command given without parameters continues the search 
of a previous Memory Search command given with the Once qualifier. The 
Repeatedly qualifier causes the search to repeat. 

You can specify expression strings as ASCII characters enclosed in quotation 
marks and/or as a list of values separated by commas. If the strings do not fit the 
specified size evenly, aU expressions in an expression string wiU be padded or 
truncated to the size specified by the size quaUfiers. 

If you specify the Once qualifier, the search stops when the expression is found. If 
you specify the Repeatedly quahfier, the debugger repeatedly searches for the 
specified expression, displaying each match until it reaches the end of the block or 
until you press CTRL C. 

When you execute the Memory Block_Operation Search command with the Once 
qualifier, subsequent Memory Block_Operation Search commands that are 
executed without expression parameters cause the debugger to continue searching 
through the originally specified address range starting from where it found the last 
match. If the expression or expression string is not found in the specified block, 
the debugger displays the message Not found. 
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See Also Memory Display 

Memory Block_Operation Copy 
Memory Block_Operation Fill 
Memory Block_Operation Match 
Memory Block_Operation Test 
Program Find First 
Program Find Next 



Examples To search for the expression 'gh' in the memory range from address lOOOh through 

address lOffh and stop when the expression is found or address lOffh is reached: 

Memory Block_Operation Search Word Once 
lOOOh. .+Oxff = 'gh' 

To execute the previous Memory Block_Operation Search command starting from 
where it found the last match: 

Memory Block_Operation Search Word Once 

To search for the hexadecimal value '65666768' in long format in the address 
range lOOOh through lOffh and stop at the end of the address range: 

Memory Block_Operation Search Long Repeatedly 
0x1000. .0xl0ff=0x65666768 
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Memory Block_Operation Test 



^ Memory ^^)— «^BIocl<_Operotiori^— Test J- 



•{ Byte y 



Word 



Long 



Repeotedly^ 



T One 




<addr>..<addr> 






<expr> 













<Return> 



The Memory Block_Operation Test command examines the specified memory 
locations specified by <addr..addr> to verify that the value(s) defined by <expr> 
or <expr_string> exist throughout the specified memory area. When the debugger 
finds a mismatch, it displays the mismatched address and value. The size qualifier 
(Byte, Word, or Long) specifies the size of an expression or expression in a string. 

If you enter a single expression value, the debugger tests the memory area for that 
value. If you specify an expression string, the debugger tests the memory area to 
verify that it is filled with the values found in the expression string. 

You can specify expression strings either as ASCII characters enclosed in quotation 
marks or as a Ust of values separated by commas. If they do not evenly fit the 
specified size, all expressions in an expression string will be padded with 
zero-valued bytes to the size specified by the size quahfier. 

Once Qualifier 

If you specify the Once qualifier, the test stops when a mismatch is found. If you 
execute the Memory Block_Operation Test command with the Once qualifier 
specified, subsequent Memory BlockjOperation Test . . . Once commands that are 
specified without parameters will continue testing through the address range 
originally specified, beginning with the last address tested. A Memory 
Block_Operation Test command given without parameters continues the test of a 



435 



Chapter 12: Debugger Commands 
Memory Block Operation Test 

previous Memory Block_Operation test command given with the Once qualifier, 
beginning with the last address tested. 

Repeatedly Qualifier 

If you specify the Repeatedly qualifier, the debugger continues testing the specified 
value(s) for mismatches until the end of the block is reached, or until you enter 
CTRL C. 



Examples To test for the expression 'gh' in the memory range from address lOOOh through 

address lOffh and stop when a word not matching the expression is found: 

Memory Block:_Operation Test Word Once 1000h..+0xff = 
'gh' 

To execute the previous Memory Block_Operation Test command starting from 
where it found the last mismatch: 

Memory Block_Operation Test Word Once 

To test for the hexadecimal value '65666768' in long format in the address range 
lOOOh through lOffh and stop at the end of the address range: 

Memory Block_Operation Test Long Repeatedly 
0x1000. .0xl0ff=0x65666768 

Mismatched values are displayed in the Journal window. 
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Memory Display 



Memory Display 

r 



^^-* ^Mnemonic ^ 



Word 



Long 





<addr> 









^-»{^ Byte ^ 




<addr> 



.<addr> 



<Return> 



J 



The Memory Display displays the contents of the specified memory locations. 
Mnemonic Option 

The Mnemonic option displays memory in assembly language mnemonics starting 
at the memory location specified by <addr>. If you do not specify an address, the 
debugger displays memory beginning with the address pointed to by the program 
counter. This command functions only in the assembly-level mode. 

If you have executed the Debugger Options Symbolics Intermixed On command, C 
source code lines will be intermixed with the assembly language code (when 
appUcable). If you have executed the Debugger Options SymboUcs 
Assem_Symbols On command, symbol references will be displayed with the 

assembly language code. 

The Prev, Next, Up, and Down keys may be used when the Code window is active 
to display instructions with higher or lower addresses. Note that the Prev and Up 
keys do not function when disassembling addresses outside of the target program. 
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Note If the AIign_bp option is set to On, the address of the first instruction in the 

assembly Code window may be incorrect after executing the Memory Display 
Mnemonic command. 



Byte, Word, and Long Options 

The byte, word, or long qualifier option displays the contents of memory locations 
specified by <addr>.. <addr> in the Journal window in both hexadecimal and 
ASCII formats. The debugger represents nonprintable ASCII characters by a period 
(.). The debugger displays memory contents in the size specified by the size 
qualifier (Byte, Word, or Long). 

If you specify an address range, the debugger displays all memory locations in that 

range. 

If you specify a single address, the debugger displays two lines of data. 

If you do not specify any parameters, the debugger displays the next 80 bytes (five 
lines) of data after the previously displayed address range. 

The memory contents are displayed in the Journal window. 

See Also Expression Display_Value 

Symbol Display 



To display disassembled memory in the Code window starting at the symbol 
'_emeg_shutdown' (this command works only in assembly-level mode): 

Memory Display Mnemonic _emeg_shutdown 

To display memory in word format in the Joumal window starting at the symbol 
'time' and ending 15 bytes after 'time': 

Memory Display Word time..+Oxf 
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Memory Flash 
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Program 
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<flQsh information> 




<Return> 


) 7 ^ 






All 



Sector 



The Memory Flash command programs or erases flash memory on the target 
system. 

Program 

This command allows programming a target flash device from data in an absolute 
or hex format file. The algorithm, and information specifying the device to be 
programmed must be entered, as well as the file to program from. Absolute and 
Hex files allow specifying an offset to be added to the addresses in the file, this 
must be a positive offset for an absolute file, but may be negative for a hex file. 
The absolute file option also allows specifying the sections within the file from 
which to program. 

Erase 

This command allows erasing aU, or specific sectors, of a target flash device. 



See Also 



Command-line to see details on command options and parameters 
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Memory Hex 




The Memory Hex command allows you to work with memory image files. 



Read 

This command allows you to read a memory image file in Motorola S record or 
Intel Hex format. The addresses in the file may be offset to generate the address in 
the target. You may choose to not set the program counter to the transfer address 
that may be in the file. 

Verify 

This command allows you to compare a memory image file in Motorola S record 
or Intel Hex format to the current contents of memory. The addresses in the file 
may be offset to generate the address in the target to compare against. Messages in 
the journal window describe differences between the two. No messages will be 
posted if the file and memory are identical. 

Write 

This command allows you to write a memory image file in Motorola S record or 
Intel Hex format. You must provide a file name and address range to write out. 
You may optionally generate a transfer address record with the current program 
counter value. 
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The command displays memory address ranges mapped as Guarded (NOMEM), 
Read_Only (ROM), or Write_Read (RAM) in the Journal window. The display 
includes a list of sections loaded and their address ranges. 

Write operations to the port will access file Vmyproj/cmdout.dat' . You must 
specify the file name in quotation marks. 
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Memory Register 

^ Memory ^^}~~*^ Register 



<Return> 



®<reg nome> 




= <value> 





See Also 



The Memory Register command clianges the contents of a register, status flag, or 
other processor variables such as PC or sp. The new contents are defined by 
<value>. 

The PC is displayed or changed if you do not specify a register name. 

If you do not specify a value in the command, values are entered interactively. You 
can enter multiple register values interactively. The debugger displays contents of 
the specified register in binary, hexadecimal, or decimal, as appropriate for the 
register. You can change the existing value by entering any legal expression and 
pressing the Return key. 

Pressing the Return key without specifying a register value terminates the 
command. 

All register names are preceded with an @ sign. 
Memory Assign 



Examples 



To modify register values interactively: 
Memory Register 

The program counter (PC) is displayed in the Journal window. You can modify the 
PC by entering a value (10a4h in this example) at the cursor prompt and pressing 
Retum. The PC will be modified, and the next register will be displayed: 



gpc = OxOOOOlOBS 

Ssp = 0x00015DB4 



4280: 10a4h 
89524 : 
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To set the value of register @dl to 44h: 
Memory Register @dl=0x44 

To interactively change the value of register @dl: 

Memory Register @dl 
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Memory Unload_BBA 




<Return> 



Note You must have the HP Branch Validator product for the processor you are 

debugging code for installed on your system in order to use this command. If you 
do not have the HP Branch Vahdator for your processor, the debugger will display 
the following error message when you attempt to execute this command: 

error code = 141 

No valid BBA spec file for <processor> processor 



The Memory Unload_BBA command unloads basis branch analysis (BBA) 
information from program memory. The BBA preprocessor (-b option) must be 
used at compile time in order for this information to exist in program memory. The 
file name bbadump.data is the default dump file name. 

Once this information has been unloaded, it can be formatted with the BBA report 
generator, bbarep (see the HP Branch Validator for AxLS C User's Guide). 



Note The Unload_BBA command is disabled when the debugger option Demand_Load 

is On. If Demand_Load is oFF but the program was loaded with Demand_Load 
On, the Memory Unload_BBA command will generate a BBA file with incomplete 
information. See the Debugger Option General conmiand description in this 

manual for more information on the Demand_Load option. 



Memory Unload_BBA All 

The Memory Unload_BBA All command unloads branch analysis information 
associated with all absolute files loaded into the file bbadump.data. 
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This command lets you run bbarep without specifying a file name. The file name 
bbadump.data is used as the default name of all dump files. 

Memory Unload_BBA All To <"dump_file"> 

The Memory Unload_BBA AU To <"dump_file"> command unloads branch 
analysis information associated with all absolute files loaded into <"dump_file">. 

Memory Unload_BBA Load_File <"load_file"> 

The Memory Unload_BBA Load_File command unloads only basis branch 
information associated with the specified absolute file (<"load_file">) into the file 
bbadump.data. 

This command lets you run bbarep without spedfying a file name. The file name 
bbadump.data is used as the default name of all dump files. 

Memory Unload_BBA Load_File <"load_file"> To <"dump_file"> 

The Memory Unload_BBA Load_File <"load_file"> To <"dump_file"> command 
unloads only basis branch information associated with the specified absolute file 
(<"load_file">) into the file <"dump_file">. 



Examples To unload all branch analysis information into file "bbadump.data": 

Memory Unload_BBA All 

To unload all branch analysis information into file "my data": 
Memory Unload_BBA All To "mydata" 

To unload branch analysis information associated with absolute file a.out.x into file 
"bbadump.data": 

Memory Unload_BBA Load_file "a. out" 

To unload branch analysis information associated with absolute file a.out.x into file 
"mydata": 

Memory Unload_BBA Load_file "a. out" To "mydata" 
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Program Context Display 



Q Program ^ Context ^ Display ^ 



<Return> 



The Program Context Display command displays the current module, function, and 
line number in the Joumal window. The current module is the one pointed to by the 
program counter. 

This command will display both the view context, as set by a Program Context Set 
command, and the context of the current program counter, if the two are different. 



Example To display the current module, function, and line number: 

Program Context Display 

Current context is: @ecs\\main\main On line 81 

See "Expression Elements" section of the "Expressions and Symbols in Debugger 
Commands" chapter for a description of debugger operators. 



Note If the PC does not point to a valid module, an alternate context is displayed. The 

alternate context is the name of the executable file that has been loaded into the 
debugger. 
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Program Context Expand 



^Program ^^)~*(^ Context Expand ^^y-- @<stacl<_level> 



<Return> 



The Program Context Expand command displays values of the parameters passed 
to a function, and the local variables in a function. The values are displayed in the 
Journal window. 

To display a function' s calling parameters and local variables, specify the 
function's stack level preceded by an at sign (@). The Backtrace window in 
high-level mode displays the function calling chain from the main program to the 
current function. The debugger displays the function stack (nesting) level beside 
each function name. The current function is level 0, the caller is always 1 , etc. 

You can use the Program Context Expand command to display the local variables 
and parameters of any function shown in the backtrace window. The calling 
parameters and local variables are accessible on the C run-time stack for functions 
in a directly-called chain from the main program to the current function. 

See Also Expression Display_Value 

Expression Monitor 
Symbol Display 



Example To display local variables and calling parameters of the function at stack level 2: 

Program Context Expand @2 
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Program Context Set 



Q Program ^^)~*^ Context ^^)~*^ Set 





<Return> 







<module 


name> 




<f unction 


ncme> 



The Program Context Set command changes the default module and function 
(context). The current module (the one to which the program counter is pointing) is 
the default when functions are referenced without a module or function qualifier. 

The default module reverts to the current module when you invoke any command 
that causes program execution, or if you execute the Program Context Set 
command without a parameter. 



Example To select module 'updateSys' as the current module: 

Program Context Set updateSys 
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Program Display_Source 

^ Program »^Display_Source ^ 



#<line nmbr> 



<function name> 





<Return> 


1 ^ 


r 



The Program Display_Source command displays C source code in the Code 
window beginning at the specified hne or function. This command works in 
high-level mode only. If you do not specify a line number or function name, the 
debugger displays the line pointed to by the program counter. 

You can display lines or functions in other modules by preceding them with a 
module name. The Next Page, Prev Page, Up arrow, and Down arrow keys 
may be used when the Code window is active to display code at higher or lower 
line numbers. 

This command does not change the current program context. 



See Also 



Memory Display Mnemonic 
Program Context Set 
Program Find_Source 



Examples 



To display line 82 of the current module in the Code window: 
Program DisplaY_Source #82 

To display the source code for function 'update_state_of_system' in the Code 
window: 

Program Display_Source update_state_of_system 

To display line 25 of module updateSys: 

Program DisplaY_Source updateSys\#25 
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Program Find_Source Next 
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Next 



<Return> 



Forward 



y 



Backward 



y 



The Program Find_Source Next command searches a high-level source program 
for the next occurrence of the string specified in the last Program Find_Source 
Occurrence command. When the debugger finds the string, it displays the line 
containing the string at the top of the Code window. 

If you specify Forward, the debugger searches forward through the file for the 
string. 

If you specify Backward, the debugger searches backward through the file for the 
string. 

If neither Forward nor Backward is specified, the debugger searches forward 
through the file for the string. 

If the debugger cannot find the specified string, it displays the message "string not 
found". The screen remains unchanged. 



See Also 



Program Find_Source Occurrence 



Example 



To find the next forward occurrence of the string specified in the last Program 
Find_Source Occurrence command: 



Program Find_Source Next 
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ProgramJ -» ^ Find_5ource ^ ^-» ^Occurrence )— ^ — Forword ^ — y x 




Backward 





<string> 













,#<line nmb 



The Program Find_Source Occurrence command searches a high-level source file 
for the first occurrence of the specified string. If you provide a line number, the 
debugger searches for the string starting at the given Une number. If you do not 
specify a line number, the string search starts at the top of the Code window. 

If you specify Forward, the debugger searches forward through the file for the 
string. 

If you specify Backward, the debugger searches backward through the file for the 
string. 

You must enclose strings containing nonalphanumeric characters in quotation 
marks. Quotation marks are not required if the string consists of only alphanumeric 
characters. 

If the debugger finds an occurrence of the string, it displays the line containing the 
string at the top of the Code window. If the string does not exist or the debugger 
cannot find it, the debugger displays the message "string not found". The screen 
remains unchanged. 

You can use the Program Find_Source Next command to search for the next 
occurrence of the specified string. 



If you specify a line number with a module reference, the debugger displays the 
source code for that module in the Code window. 



See Also 



Program Display_Source 
Program Find_Source Next 
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Examples To search forward through the current module for the string 'time' : 

Program Find_Source Occurrence Forward 'time' 

To search backward through the current module for the string 'time', starting at hne 
237: 

Program Find_Source Occurrence Backward 'time', #237 

To search forward through the module 'main', for the string 
system_is_running, beginning at line 1: 

Program Find_Source Occurrence Forward 
" SYStem_is_running" , main\#l 

The Program Interrupt Add command causes a simulated program interrupt. The 
debugger/emulator implements simulated interrupts in the same way that they are 
implemented in HP 64000 emulators. Interrupts are generated as a result of host 
software requests. The debugger/emulator allows you to control frequency of 
interrupts using the <delay> parameter. This parameter controls the length (in 
microseconds) of a delay loop within the simulated interrupt polUng routine. 
Interrupt frequency cannot be precisely timed, because a software polling loop on 
the host causes the interrupt and host system loading (and therefore polling loop 
speed) cannot be predicted. The maximum number allowed for <delay> is 
(2**32)- 1. 
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Program Load 
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The Program Load command loads and reloads the specified executable module 
into the debugger and also allows you to set default options for loading executable 
modules. 

Option_Set Parameter 

This parameter and its qualifiers let you specify defaults for loading executable 
modules. These defaults affect the Program Load Default or command hne 
program load commands. You can Ust the Program Load defaults with the 
Debugger Option List command. 
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Default Parameter 

When you specify the Default parameter, the debugger loads the executable 
module according to the options set with the Program Load Option_Set command. 

Reload Parameter 

The Reload parameter reloads only the code image for the current absolute file 
(that is, the file at the root of the current symbol tree). This is a shorthand way to 
reload code without having to look up the file name. Monitored expressions in the 
Monitor window will not be cleared; software breakpoints will be cleared. 

New/Append Parameters 

The New parameter loads a new program, removing any old program that may have 
been loaded. The New parameter optionally allows you to load the program image, 
the program symbols, or both. The program counter can be set from the transfer 
address in the load file or ignored. 

The Append parameter loads another program without deleting the existing 
program. 

If you enter the Program Load command with the New, Append, or Options 
parameter, the following qualifiers are available: 

All Both the program image and program symbols to be loaded. 

Code_Only Only the program image is loaded. 

Symbols_Only Only the program symbols are loaded. 

Pc_Set The program counter is set from the transfer address in the 

load fUe. 

No_Pc_Set The program counter is not reset. 

Using the AU or Symbols_Only qualifiers along with the Pc_Set qualifier resets 
static variables for a complete restart. 

The optional root parameter (,<root>) allows you to specify an alternate name for 
the root of the symbol tree. 

The base address (&<base_addr>) allows PC relative code to be shifted upon 
loading. 
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The section list (;<section>) enables partial loading of absolute file sections, i.e., 
prog, data, const, etc. The symbols for all sections wiU be reloaded. 

Resetting Program Variables 

To reset static and global program variables after entering a Debugger Execution 
Reset_Processor or Program Pc_Reset command, you must reload your program by 
using the Program Load command. For faster loading, specify Program Load New 
Code_Only. The debugger retains symbol information. You do not have to reload 
symbol iirformation if symbol addresses have not changed. 

The address where the object module will be loaded is specified at Unk time. 
However, the address can be changed by specifying a new base address. 

See Also Debugger Execution Reset_Processor 

Program Pc_Reset 

Debugger Option General Demand_Load 
Debugger Option List 



Examples To load absolute file ' ecs' , remove all existing program symbols, reset the program 

counter, and load the fuU symbol set: 

Program Load Default ecs 

To load only the program image of the prog section of absolute file 'ecs' without 
resetting the program counter: 

Program Load New Code_Only No_Pc_Set ecs; prog 
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Program Pc_Reset 



Program ) "4 Pc_Reset ) — <Return> 



The Program Pc_Reset command resets the program counter (PC) to the transfer 
address from the absolute file. This causes the next Program Run or Program Step 
command to restart execution at the beginning of the program. The command does 
not clear breakpoints. 

See Also Debugger Execution Reset_Processor 

Program Load 
Program Run 



Example To reset the program counter to the transfer address from the absolute file: 

Program Pc_Reset 
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Program Run 



Program 
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f romReset 
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:;-t:,it_:,. . r> 











<break_addr> 









%%<pass_count> 





<Return> 







,<macro_caU> 



The Program Run command starts or continues target program execution. The 
program runs until it encounters a permanent or temporary breakpoint, an error, or 
a stop instruction, or until you press CTRL C. 

The Program Run command may be used to resume execution after program 
execution has been suspended. 



Program Run From 

The Program Run From command begins program execution at the specified start 
address <start_addr>. 

Using the Program Run From command to specify a starting address in high-level 
mode may cause unpredictable results if the compiler startup module is bypassed. 

Program Run fromReset 

Resets processor and then starts execution as the processor does when reset. 
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Program Run Until 

The Program Run Until command begins program execution at the current program 
counter address and breaks at the specified address. 

Break Address 

The break address (<break_addr>) acts as a temporary instruction breakpoint. It is 
automatically cleared when program execution is halted. Multiple break addresses 
are ORed. For example, the command 

Program Run Until #20, #90 Return 

causes the program to run until either line 20 or line 90 is encountered, whichever 
occurs first. 



Note 

The debugger/emulator implements instruction breaks using software breakpoints. 
Therefore, break addresses cannot be specified for addresses in target ROM. 



Pass Count 

The pass count (<pass_count>) specifies the number of times the break address is 
executed before the program is halted. For example, a pass count of three will 
cause the program to break on the fourth execution of the break address. 

Macro Calls 

If specified, a macro (<macro_name>) is invoked when the temporary break occurs. 

See Also Breakpt Access 

Breakpt Clear_All 
Breakpt Delete 

Breakpt Instr 
Breakpt Read 
Breakpt Write 
Program Pc_Set 
Program Step 
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Examples To execute the target program starting at address 'main' : 

Program Run From main 

To begin program execution at the current program counter address and run until 
line 110 of the current module: 

Program Run Until #110 

To begin program execution at the current program counter address, run until the 
program returns to the calling function of the current function, and then execute the 
macro 'read_val': 

Program Run Until @1; read_val () 
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Program Step 



Program ^^—-(^ Step ^ 



From 





<start addr> 








, . 


r 







^-»{^ Count y 



,<step_count> 



<Return> 



<step_count> 



The Program Step command executes the specified number of instructions or lines, 
beginning with the location identified with <start_addr>. In high-level mode, 
single-stepping is done one C source line at a time. In assembly-level mode, 
single-stepping is done one machine instruction at a time. When the program calls 
a function, stepping continues in the called function. 

If you do not specify a starting address, single- stepping begins at the address 
contained in the program counter. 

If you do not specify a step count (<step_count>), the debugger will either step one 
C source Une or one machine instruction. 



Note 



If the debugger steps into an HP library routine, you can then use the Program Run 
Until @ 1 (stack level 1) command to run to the end of the library routine. 



Program Step From 

The Program Step From command executes one instruction or line, beginning with 
the location specified by <start_addr>. If you do not specify the optional step count 
(<step_count>), the debugger executes one line or one instruction. 
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Program Step Count 

The Program Step Count command executes the specified number of either 
instructions or lines, starting at the location pointed to by the program counter. 

The debugger updates the screen after each instruction or Une is executed. If a 
breakpoint is encountered, single-stepping is halted. 

You can also use function key F7 to single-step. 

See Also Breakpt Instr 

Program Run 
Program Step Over 
Program Step With_Macro 



Examples To step four source lines, starting at Une 39: 

Program Step From #39,4 

To step ten source lines (high-level mode) or ten processor instructions 
(assembly-level mode), starting at the program counter address: 

Program Step Count 10 

To step one source line (high-level mode) or one processor instruction 
(assembly-level mode), starting at the program counter address: 

Program Step 



461 



Chapter 12: Debugger Commands 
Program Step Over 



Program Step Over 




<Return> 



The Program Step Over command executes the number of instructions or lines 
specified, but executes through function calls, that is, the called function is 
executed without stepping through it. Execution begins at the specified starting 
address. 

When the debugger encounters a C function or assembly-level subroutine caU and 
then continues stepping when the called subroutine returns. 

In high-level mode, the debugger executes one C source hne at a time. In 
assembly-level mode, the debugger executes one microprocessor instruction at a 
time. 

If you do not specify a starting address, single- stepping begins at the address 
contained in the program counter. 

If you do not specify a step count (<step_count>), the debugger will either step one 
C source hne or one machine instruction. 

Program Step Over From 

The Program Step Over From command executes one instruction or line, beginning 
with the location specified by <start_addr>. If you do not specify the optional step 
count (<step_count>), the debugger executes one line or one instruction. 
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Program Step Over Count 

The Program Step Over Count command executes the specified number of either 
instructions or lines, starting at the location pointed to by the program counter. The 
debugger updates the screen after each instruction or line is executed. If the 
debugger encounters a breakpoint, it halts single-stepping. 

You can also use function key F8 to single-step over functions. 

See Also Breakpt Instr 

Program Run 
Program Step Count 
Program Step From 
Program Step With_Macro 



Examples To step four source lines, starting at Une 39, and execute through any function calls: 

Program Step Over From #39,4 

To step ten source hues (high-level mode) or ten processor instructions 
(assembly-level mode), starting at the program counter address, and execute 
through any function calls: 

Program Step Over Count 10 

To step one source line (high-level mode) or one processor instruction 
(assembly-level mode), starting at the program counter address, and execute 
through any function calls: 

Program Step Over 
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Program Step With_Macro 

Program Step ^^)—g{^ With_ Macro ^ )—»- <macro_oall> 



<Return> 



The Program Step With_Macro command single steps through the program and 
executes the specified macro {<macro_call>) after each instruction or high-level 
line. Program execution continues if the macro returns a nonzero value. 

Single-stepping is done by C source hue in high-level mode and by microprocessor 
instruction in assembly-level mode. 



See Also Program Run 

Program Step From 
Program Step Over 



Example To step through the program one source line (high-level mode) or one processor 

instruction (assembly-level mode) at a time, executing the macro read_var after 
each step: 

Program Step With_Macro read_var() 
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Symbol Add 



Symbol ^)~~*'{^ 



Add 





<symbol name> 


T~* 



<type> 



<Tab> Address ^^)— »■ <target_mem_address> 



<Return> 



<Tab> -«>(^ Fill_Mem ^ 



<value> 



The Symbol Add command creates a symbol and adds it to the debugger symbol 
table. When defining a symbol, you must declare the symbol's name. It may be any 
name not previously used. 

Type 

You can optionally assign any valid C data type <type> to the symbol. If you do 
not assign a data type, the symbol type defaults to type int. 

If the symbol type is a pointer, the initial value must be a data address. If the type is 
an array, the initial value must be a string of values separated by commas and/or 
enclosed in quotation marks. If fewer values are given than will fill the array, the 
pattern is repeated until the entire array is filled. 

When initializing symbols, the symbol type is not used. Only the size is used. If a 
char array is defined, it is filled with the specified pattem in the same way as with 
the Memory Block_Operation Fill command. A zero is not appended to char 
arrays. The size is not determined by the string as in C. Complex values such as 
floating point representation are not recognized. 
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Program Symbols 

Program symbols are specified with a base address (Address 
<target_memory_address>). The base address references an address in target 
memory. Program symbols are identical to variables defined in a C or assembly 
language program. The value of a program symbol is placed in target memory. If 
an initial value is specified for the program symbol, the value is loaded in the 
memory location referenced by the symbol. If an initial value is not specified, the 
memory location referenced by the symbol is not changed. 

Debugger Symbols 

Debugger symbols are specified without a base address and are not associated with 
a target memory address. Debugger symbols may be used to aid and control the 
flow of the debugger. They are located at a fixed location in debugger memory. 
Only debugger commands and C expressions in macros can refer to debugger 
symbols. They cannot be referenced by the program in target memory. 

If an initial value is specified for the debugger symbol, the value is loaded in the 
memory location referenced by the symbol. If an initial value is not specified, the 
memory location referenced by the symbol is set to zero. 

See Also Debugger Macro Add 

Symbol Display 
Symbol Remove 



Examples To add a program symbol of type int (default) at target memory address 9ff0h and 

set the memory location to value -1 : 

Symbol Add EOF Address 9ff0h Fill_Mem -1 

To add a debugger symbol named strl of type char referencing an eight-character 
array and fill the array with string ' abcdefgh' : 

Symbol Add char strl [8] Fill_Mem 'abcdefgh' 

To add a debugger symbol of type short named si and fill the memory location 
with value 0x10203: 

Symbol Add short si Fill_Mem 0x10203 
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In this example, we assigned a value to the symbol that is too large for the specified 
type. In this case, the debugger fills the memory location with the lower bytes of 
the specified value. Executing the command: 

Expression Printf "%x",sl 

shows that the value is 203, the lower two bytes of the specified value. 
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Symbol Browse 



r Symbol ^"""^ Browse 



<class_name> 



<RETURN> 



The Symbol Browse command displays the parents and children of a C++ class. 
The inheritance relationship is displayed in the Journal window. 

Example To display the parents and children of the C++ class fruit, type: 

Symbol Browse fruit 
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Symbol Display 



Symbol )— »-( Display 



Default 



Options 



Warnings 



Data&macros 



Functions&labels 



Modules 



Types 



.Search A 



Wide 



^;;^^^End_OptiQns^ 





<symbol nanne> 




<Return> 




^ r ' 



Reserved _Synnbols)~ 



The Symbol Display command displays symbols and associated information in the 
Joumal window. 
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To display symbols in all modules, specify a backslash as the command argument. 
Symbol Display Default \ 

To displays all symbols in a specified module or function, enter a module name or 
function name followed by a backslash. 

Symbol Display Default memset\ 

The wildcard character * may be placed at the end of a symbol name with any 
option. The * can be used to represent zero or more characters. If used with no 
symbol name, * is treated the same as\, that is, all symbols are displayed. 

If you enter a symbol name without a module specification, the debugger looks for 
the symbol in the current module. If there is no module quahfier, all symbols with 
the specified name will be displayed, including global symbols and symbols local 
to the module. Global symbols are not attached to a module. 

Symbol Display Default dest 

If you specify a structure name using the Types option, the debugger shows all 
members in the structure and their types. 

Default 

If you specify Default, the debugger displays all types of symbols. 
Options 

The following options may be specified to display subsets of symbols. 

Data&macros displays symbol name, storage class, data type, and 

addresses of data and macro symbols. 

Functions&labels displays symbol name, storage class, data type, return type, 
and addresses of functions and labels. 

Modules displays names, module type (high-level, assembly-level, 

or non-loaded), and section addresses of modules. 

Types displays all symbol types. 

Search_All displays symbols of all types in all roots (contexts). 
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Wide shows symbol names only in multicolumn (compressed) 

format. 

If you do not specify any options, the debugger displays all symbols. 



Warnings 

When you execute the Symbol Display Warnings command, the debugger displays 
type mismatches. Mismatches occur when global variables are declared with 
different types in different modules or global functions are declared with different 
retum types or argument counts in different modules. The conmiand displays all 
mismatches and the names of the modules in which the symbols are declared. 

Reserved_Symbols 

If you specify Reserved_Symbols, the debugger displays processor reserved 
symbols, registers, and internal debugger variables. 

See Also Symbol Add 

Symbol Remove 



Examples To display the symbol 'updateSys' in the current module: 

Symbol Display Default updateSys 

Symbol Display Default updateSys 

@ecs\\updateSys : Type is High level module. 

Code section = 00001436 thru 00001C21 

To display all symbols in module 'updateSys': 
Symbol Display Default updateSysX 

> Symbol Display Default updateSysX 
Root is: updateSys 

@ecs\\updateSys : Type is High level module. 

Code section = 00001436 thru 00001C21 
updateSys\update_state_of_system 

: Type is Global Function returning void. 
Address = 00001436 thru 00001513 

update_state_of\ re fresh 

: Type is Local int. 
Address = Frame + 8 
update_state_of \interval_complete 

: Type is Local int. 
Address = Frame + 12 
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To display all modules in the current symbol tree: 

Symbol Display Options Modules End_Options \ 

Symbol Display Options Modules End_Options \ 
Root is: @ecs 

31 source and 23 assembler modules, 28 source procedures. 
Filename = ecs.x 

@ecs\\main : Type is High level module. 

Code section = 00001050 thru 00001121 
Code section = 00000100 thru OOOOOlOB 

@ecs\\initSystem : Type is NON-LOADED module. 

Code section = 00001122 thru 00001435 



To display all function and labels in module 'main': 

Symbol Display Options Function&labels End_Options main\ 

To display all reserved symbols: 

Symbol Display Reserved_Symbols 

To display all symbols in module systemint in compressed format (symbol names 
only): 

Symbol Display Options Wide End_Options systemlntX 

Symbol Display Options Wide End_Options systemlntX 
Root is: systemint 

systemlntX system_interrupt function 

struct_system_clock hours minutes 
seconds struct_system_clock * 

tick_clock function argument_l system_interrupt 
tick_clock time reg_paraml 

increment 

To display all data and macros found within any symbol tree (that is, search W, 
@a.out\\, @filel\\,etc.): 

Symbol Display Options Data&Macros Search_All 
End_Options \ 

Symbol Display Options Data&macros Search_All End_Options X 
Root is : @ecs 

31 source and 23 assembler modules, 30 source procedures. 
Filename = ecs.x 

update_state_ofX re fresh 

: Type is Local int. 
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Address = Frame + 8 
update_state_of \interval_complete 

: Type is Local int. 
Address = Frame + 12 

To display data type struct_temp_settings: 

Symbol Display Options Types End_Options 
struct_temp_settings\ 

Symbol Display Options Types End_Options struct_temp_settings\ 
Root is: struct_temp_settings 

@ecs\\struct_temp_settings 

: Type is Type definition of Structure, size 

= 8. 

struct_temp_set\temp : Type is Member of type float. 

Offset = 0 

struct_temp_set\humid : Type is Member of type int. 

Offset = 4 

To display any type mismatches detected in the user program during program 
loading, along with the address of the symbol that has the mismatch: 

Symbol Display Warnings 

2 mismatches. 

getOpInput\system_of f : Type is Global Function returning void. 

Address = 000024AE to 000025ED 

modules mismatched *** 
Modules ; ' main' 
updateSys\write_output_command 

: Type is Global Function returning void. 
Address = 00001944 to 0000197B 
*** 1 modules mismatched *** 
Modules: 'getOpInput' 
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Symbol Remove 



Symbo7~ ^^)->(^~Re 





<symbol name> 




<Return> 






^ , — ^ 





The Symbol Remove command removes the specified symbol from the symbol 
table. Only program symbols and user-defined debugger symbols can be deleted 
from the symbol table. 

To delete all symbols within a named module or function, append a backslash (\) to 
the module or function name (<symbol_name>). 

Symbol Remove updateSysX 

Entering a backslash without a module or function name deletes all symbols in aU 
modules. 

Symbol Remove \ 

If you specify a symbol name without a module specification, the debugger looks 
for the symbol in the current module. 

If you specify more than one symbol to be deleted or if the specified symbol has 
local symbols (for example, when a macro is deleted), the debugger requests 
confirmation. Entering , y after the symbol name provides automatic confirmation 
of the request. This option is useful in command files. 

The debugger lets you add a debugger symbol with the same name as a target 
module's local symbol or a predefined macro's local symbol. If you do add a 
debugger symbol with same name as a local symbol, you must specify the entire 
symbol name with the Symbol Remove command in order to remove it. For 
example, if you added the debugger symbol alter_settings when running the 
demonstration program, you must &a\.er\^lter_settings instead of alter_settings to 
delete the symbol because there is a local symbol alter_settings in target module 
updateSys. Otherwise the error message error #152, Cannot delete: more than one 
symbol with this name is displayed. 



See Also 



Symbol Add 
Symbol Display 
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Examples To delete symbol 'current_targets' in function 'alter_settings' : 

Symbol Remove alter_settings\current_targets 

To delete all symbols in module 'updateSys': 
Symbol Remove updateSys \ 

To delete symbol 'alter_settings' in module 'updateSys': 
Symbol Remove updateSys\alter_settings 

In this example, the symbol being removed is a function which contains other 
symbols. The debugger prompts you with the message 'This symbol has a 
sub-tree. Delete with sub-tree? (Y/N)' . Enter 'Y' to delete the symbol and its 
sub-tree. If you respond with 'N', the command is canceled. 

To delete all symbols in all modules: 

Symbol Remove \ 



475 



Chapter 12: Debugger Commands 
Trace Again 



Trace Again 



Trace 



<Return> 



The Trace Again starts a trace using the last (previous) trace specification. The 
trace starts on the next program run or step command. 

If no trace has been previously specified, this command is equivalent to entering a 
Trace Trigger Never command, and states are collected until you enter a 
Tra ce Halt coinmand. 



Example To start a new trace using the last trace specification: 

Trace Again 
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Trace Display 



Trace ^^)~~{^ Display 



Modules 



Source 




Assembly 



□□to 




Row 



Output To -(^window_nmbr> 



,.<end_line> 




<Return> 





<start_line> 




<Tab> 











The Trace Display command displays trace information in the specified window. If 
no window is specified, the trace output wiU go to the Trace Mode window, and the 
debugger willl enter "trace mode." 
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Data may be displayed (interpreted) in several ways: from module and function 
entry and exit points, to raw bus data. The default display will show modules and 
source line references only. 

Trace mode 

In trace mode, the trace information is displayed in the View window. You cannot 
enter debugger commands from the command line while in trace mode. To return 
to debugger command mode, press the Esc key twice. 

In trace mode, you can use the cursor keys to scroll the trace information in the 
View window. Use the Next and Prev keys to page through the trace output. 

Function keys Function keys Fl, F3, F4 and F5 do their normal functions 
when you are in trace mode. However, Fl (Next Window) activates only the Code 
or Trace Mode windows. You can use the F3 function key to switch between the 
high-level and assembly-level displays in the Code window when tracking trace 
data. 

F2, F6, Fl, and F8 have special functions when in the trace mode. Function key 
F2 lets you enter a new line number to display at the top of the trace list display. 
The F6 function key changes the track direction (backward or forward) in the trace 
window. The F 7 function key scrolls the trace list up or down in the Trace Mode 
window and updates the Code window so that the highlighted line corresponds to 
the new first line displayed in the Trace Mode window. The F8 function key 
toggles the top line high-level module identification on or off to allow an extra line 
of trace information to be displayed. The top line high-level module identification 
must be on to enable tracking. 

Tracking source code The debugger gives you the capability to correlate the 
data in the trace display with source code displayed in the Code window. To view 
trace information in relationship to the source code, select a line in the trace list 
with the cursor and then press F7 or the Return key. This updates the Code 
window so that the highlighted hne in the code window corresponds to the first line 
displayed in the Trace Mode window. Pressing F 7 or the Return key again 
scrolls the trace list in the Trace Mode window and updates the Code window so 
that the highlighted hne corresponds to the new first hne displayed in the Trace 
Mode window. 

Press the F6 function key to change the track direction (backward or forward) in 
the Trace Mode window. The trace direction is indicated on the bottom border of 
the Trace Mode window ( ^ or v). The symbols show which direction the search 
will proceed through the trace buffer to find the next high-level or assembly code 
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line (depending on the Code window selected). If the trace window has no lines 
that correspond to code lines, the search will proceed to the end of the trace buffer. 

If you have specified storage qualifiers, the trace data may not track sequentially 
with the lines in the code display. 

Directing output to a specified window or file 

Use the OutputTo keyword to redirect trace output to a window or file other than 
the View window. The following values are valid window numbers for trace output: 



Line(s) keyword 

Use the Line(s) keyword to specify a range of Unes to be copied from the trace 
buffer to the specified window. For example, to copy lines -110 through -90 from 
the trace buffer to the journal fUe, enter the command: 

Trace Display Line{s) -110.. -90 <Tab> OutputTo 29 

You caimot specify a hne range for trace output when entering trace mode. 
However, you may specify the first hne to display in trace mode. For example, to 
display the trace buffer starting at line -110, enter the command: 

Trace Display Line(s) -110 



1 

10 
24 
28 

29 



high-level Journal window 
assembly-level Joumal window 
View window 
log file 
journal file 
user-defined windows 



50 - 256 
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Display qualifiers 

The following display qualifiers let you select what information is written to the 
output window and how the iirformation is formatted. 

Line(s) Specifies the starting line or the range of lines to display or 

copy. Line 0 is the trigger cycle. You cannot specify a range 
when entering trace mode. 

Modules Displays names of module the trace lines are in, entering, or 

re-entering. This is useful for showing general program flow. 

Source Display the source lines and Une numbers corresponding to 

instruction fetches. 

Assembly Displays assembly language instructions. Information is 

displayed symbolically when possible. 

Data Displays address, value, and read/write status for data accesses. 

Information is displayed symbohcally when possible. 

Raw Display the frame number, address, data and status for a bus 

cycle with no interpretation of the data. 

Displaying status information Status information is displayed mnemonically 
in the trace hst. The following table describes the mnemonics that may be 
displayed. 

Note that function code, access size, and port size may not be displayed if the 
processor FC, SZ, or DSACK lines are remapped as chip select Unes. 

Mnemonic Description 



Function Code Space 

User Cycle occurred in user space 

Supv Cycle occurred in supervisor space 

Prog Cycle occurred in program space 

Data Cycle occurred in data space 
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FCO Cycle 

FC3 Cycle 

FC4 Cycle 

CPUspace Cycle 

DMAspace Cycle 
(68360 only) 



used function code 0 
used function code 3 
used function code 4 
refers to CPU space 
refers to DMA space 



Cycle Type 



Code Fetch Cycle was a code fetch 

DMA cycle Cycle was a DMA cycle 

Read Cycle was a read cycle 

Write Cycle was a write cycle 

Copr Cycle was a coprocessor cycle 

Intl Cycle was an internal cycle 

(cycle was an access to an onboard peripheral) (68332 only) 

Intr Ack Cycle was a interrupt acknowledge cycle 



Access Size (see processor 'SZ' lines) 

Byte Byte instruction, fourth byte of a long access to an 8-bit port, 

or second byte of a word access to an 8-bit port 
Long Instruction causing this access refers to long data 

3 Byte Second byte of a long access to an 8-bit port 

Word Word instruction, third byte of a long access to an 8-bit port, 

or second word of a long access to a 16-bit port 



Port Size (see processor 'DSACK' lines) 

ds8 Hardware port is 8-bits wide 

ds 16 Hardware port is 16-bits wide 

ds32 Hardware port is 32-bits wide 



Trace status character When trace data is displayed, a trace status character 
may be displayed in front of the trace Une. The following table defines the trace 
status characters. 



Trace List Status Characters 



Character Description 



481 



Chapter 12: Debugger Commands 
Trace Display 



* The indicated trace line is the trigger condition. 

+ The indicated trace line is an assembly language statement 

within a high-level statement, that is, not the first assembly 
language statement in the high-level source statement. 

! The data field in the trace buffer line does not match the data in 

memory. 

? The trace line may be a prefetch. 



Examples To display source lines, their corresponding assembly language instructions, and 

data read and write cycles: 

Trace Display Modules Source Assembly Data 

To copy the raw data in lines -20 through +20 of the trace buffer to a log file you 

have opened: 

Trace Display Lines -20.. 20 <Tab> Raw OutputTo 28 
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Trace Event Clear All 



Trace 



Event 



Clear AN 



<Return> 



The Trace Event Clear_All command clears (removes) all specified events that are 
not used by the trigger or store quaUfier. 

See Also Trace Event Delete 



Examples To clear (remove) all defined trace events: 

Trace Event Clear_All 
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Trace Event Delete 



Trace )— *{ Event Delete )— »■ <event nmbr> —— <Return> 



The Trace Event Delete command deletes (removes) a previously defined event 
specification. You cannot delete an event that is used by the trigger or store 
qualifier. 

See Also Trace Event Clear_All 

Trace Event Specify 



Examples To delete event 2: 

Trace Event Delete 2 
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Trace Event List 



Trace V""^ Event ^""^ List 



<event nmbr> <Return> 



The Trace Event List command lists the definition of the event specified by 
<event_nnibr> in the View window. The definition includes address, data, and 
status. The coimnand used to define the event is listed, as well as an indication if 
the event is used by the trigger or quaUfier. 



See Also Trace Event Specify 



Examples To list the definition of event 3 in the View window: 

Trace Event List 3 
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Trace Event Specify 

Trace Event ^ )~*{^ Specify ^ )-- <event_nmbr> - 



r 



Addn 



Data 



Status 



Not 




Not 




<addr_spec> 





<Tab> 









<data_spec> 





<Tab> 









Read 



Size 



> 



Byte 



Word 



3 Byte 



Long 



FnCde 



Data 



Prog 



<Return> 



Supr 



User 



^-»{^ CycTyp "{^ Fetch ~ 'y 



CPU 



DMA 



The Trace Event Specify command defines an event (detectable bus condition to be 
used for trace qualifying or triggering. The event number (<event_nmbr>) must be 
a number between 1 and 30 inclusive. Bus conditions may be address values, data 
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values, or status values. The event is trae if all of the terms defined in the event are 
true at the same time. 

Event conditions 

Three types of conditions can be specified in an event definition. The three 
condition types are: 

Address The value that appears on the address bus. The address term 

matches an address, range of addresses, or out-of-range 
addresses. 

Data The value that appears on the data bus. The data term matches a 

data value or range of values. The data size is that of the data 
field as specified by the analyzer. This typically matches the 
processor bus size. 

Status The type of bus activity, for example: instruction fetch, read, 

write, etc. 

If you use the keyword Is, the event is defined as the specification that follows. If 
you use the keyword Not, the event is defined as the logical NOT of the 
specification that follows, that is, any condition that does not match the 
specification. For example, if you enter the specification: 

Trace Event Specify 1 <Tab> Address Is 0xl0b6 . . 0xl23d 

event 1 is defined to be any address in the range 0xl0b6 through 0xl23d. If you 
enter the specification: 

Trace Event Specify 1 <Tab> Address Not 0xl0b6 . . Oxl23d 
event 1 is defined to be any address outside the range 0xl0b6 through 0xl23d. 

Address and data values 

Address values {<addr_spec>) and data values {<data_spec>) are specified 
as 32-bit values or a range of 32-bit values denoted by (..). You can specify address 
values using module names, symbols, and high-level Une numbers. See the 
"Expressions and Symbols in Debugger Commands" chapter for detailed 
information on how to specify addresses. 



487 



Chapter 12: Debugger Commands 
Trace Event Specify 

A mask can be used to specify a range with a 32-bit value that marks valid bits in 

addresses or data. For example, to specify only addresses in the range OOOOlSxxh 
(where xx are "don't care" values), you could enter the command: 

Trace Event Specify 4 <Tab> Address Is 
0x1500 &= OxffffffOO 

The (S= is the bit mask operator. This range could also have been specified as 
0x1500. .Oxl5ff. 

Status values 

Status conditions are the types of bus activities you wish to specify. The following 
keywords are used to specify the status condition: 



Read specifies read operation 

Write specifies write operation 

Size specifies access size (byte, word, 3 byte, or long) 

FnCde specifies function code ( data or program, supervisor or user 

mode) 

CycTyp specifies cycle type (fetch, CPU, or DMA) 



Addresses specified witha a CycTyp of Fetch will be masked to the size specified 
by Debugger Option Trace Fetch_Align. 

See Also Trace Event Clear_All 

Trace Event Delete 
Trace Event List 

Debugger Option Trace Fetch_Ahgn 



Examples To define event 1 to be the address of function update_state_of_system: 

Trace Event Specify 1 <Tab> Address Is 
updat e_s tat e_o f _s y s t em 

To define event 2 to be any bus cycle corresponding to an instruction fetch: 
Trace Event Specify 2 <Tab> Status Is CycTyp Fetch 
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To define event 3 to be a write access of variable current_humid offset by 2. 

Trace Event Specify 3 <Tab> Address Is 

& (H B) current_humid+2 <Tab> Status Is Write 

The H B (hex byte) type cast allows you to specify an offset of two so that the 
debugger can capture the two least significant bytes of current_humid, a 32-bit 
integer value. 

If an 8-bit wide I/O port at OfxxxOOlOh has a "data valid" bit at bit 3, you can 
specify a trace event when the "data valid" bit is read by entering: 

Trace Event Specify 5 <Tab> Address Is 

OfOOOOOlO &= OxfOOOffff <Tab> Data Is 0x8 &= Oxff 
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Trace Event Used List 



Trace ) =-{ Event ) K Used List ) <Return> 



The Trace Event Used_List command lists the numbers of the events that are 
currently defined and whether or not the event is being used (specified in a Trace 
Trigger or Trace StoreQual definition). 

See Also Trace Event Specify 

Trace Trigger Event 
Trace StoreQual Event 



Examples To list the currently defined events and their status (used or not used): 

Trace Event Used_List 
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Trace Halt 



Trace •i Halt " <Return> 



The Trace Halt command stops (terminates) the trace currently being executed. If a 
trace is not in progress, this command has no effect. After executing this command, 
you can display any trace data collected. 

See Also Trace Again 

Examples To stop the current trace: 

Trace Halt 
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Trace StoreQual 



Troee ^)~*^ StoreQual 



Pi-estoi-e 



Address — » ^ is ^ 



Not 



<addr_spec> 



<Tab> 



^— (~~Dota~~~W — Is ^ 




Not 



<dota_spec> 





<Tab> 









^-» ( Stotus ) -^^ — > { Is ) /• — Reod } - 




Not 



^*(^ Wri 



Size ^ 



te 



•{ Byte )- 



Word 



Long 



^-»(^ FnCde ^ — Doto ^ 



Prog 



»( Fetch ^ 



<Return> 



Supr 

^-»(^ User ^ 



CPU 



DMA 



The Trace StoreQual command immediately specifies the bus conditions to be 
stored (captured) in the trace buffer. Bus conditions may be address values, data 
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values, or status values. When you define a storage qualifier, you are essentially 
defining an event. You can also use the Trace Event Specify command to 
define an event, and then use the Trace StoreQual Event command to use 
the specified event as a storage qualifier term. 

Storage qualifier conditions 

Three types of conditions can be specified as storage quahfiers. The three condition 
types are: 

Address The value that appears on the address bus 

Data The value that appears on the data bus 

Status The type of bus activity, for example, instruction fetch, read, 

write, CPU, etc. 

If you use the keyword Is, bus cycles matching the specification that follows are 
stored in the trace buffer. If you use the keyword Not, the storage qualifier is 
defined as the logical NOT of the specification that follows, that is, any bus cycles 
that do not match the specification are stored in the trace buffer. For example, if 
you enter the specification: 

Trace StoreQual Address Is 0xl0b6 . . Oxl23d 

the storage qualifier is defined to be any address in the range 0xl0b6 through 
0xl23d. If you enter the specification: 

Trace StoreQual Address Not 0xl0b6 . . Oxl23d 

the storage qualifier is defined to be any address outside the range 0xl0b6 through 
Ox 123d. 

Address and data values 

Address values (<addr_spec>) and data values i<data_spec>) are specified 
as 32-bit values or a range of 32-bit values denoted by (..). You can specify address 
values using module names, symbols, and high-level hne numbers. See the 
"Expressions and Symbols in Debugger Commands" chapter for detailed 
information on how to specify addresses. 

A mask can be used to specify a range with a 32-bit value that marks valid bits in 
addresses or data. For example, to store only addresses in the range OxOOOOlSxx 
(where xx are "don't care" values), you could enter the command: 
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Trace StoreQual Address Is 
0x1500 &= OxffffffOO 

where is the bit mask operator. 

This format is used because the C language does not have a way to represent a 
don't care literal. 



Note Execute the Debugger Execution Environment SyncSIM command 

before specifying an event with an address to ensure that the analyzer interprets the 
chip selects properly for the address. See the description of the Debugger 
Execution Environment Sy/icSJMcommand. 



Status values 

Status conditions are the types of bus activities you wish to specify. The following 
keywords are used to specify the status condition: 



Read specifies read operation 

Write specifies write operation 

Size specifies access size (byte, word, 3 byte, or long) 

FnCde specifies function code ( data or program, supervisor or user 

mode) 

CycTyp specifies cycle type (fetch, CPU, or DMA) 



Addresses specified with a CycTyp of Fetch will be masked to the size specified by 
Debugger Option Trace Fetch_Align. 

Prestore 

Specifying Prestore in your storage qualifier definition causes the trace 
function to store up to two instruction fetch cycles preceding the qualified 
condition being stored. This lets you view the instructions leading up to the 
qualified state. 
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See Also Trace StoreQual Event 

Trace StoreQual List 

Trace StoreQual None 

Debugger Option Trace Fetch_Align 



Examples To store accesses to update _state_of_sy stem along with the two bus cycles 

immediately preceding the accesses. 

Trace StoreQual Address Is update_state_of_systein 
Prestore 

To store only instruction fetches with an opcode value of 4e5x where x is a don't 
care value: 

Trace StoreQual Data Is 0x4e50 &= OxfffO <Tab> Status 
Is CycTyp Fetch 

The don't care condition is specified by specifying a mask in the data specification. 
(S = is the mask operator. This value corresponds to the LINK and UNLK 
instructions. 
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Trace StoreQual Event 



Trace )— ^ StoreQua 




<event nmbr> 




<Return> 









The Trace StoreQual Event command lets you specify an event or combination of 
events defined with the Tra ce Even t Specify command as the storage 
qualifier. 

Events 

Each event that you define using the Trace Event Specify command is assigned an 
event number between 1 and 30. This number (<event_imibr>) is used to assign an 
event to be a storage qualification term. The storage qualification term can be a 
single event or a logically OR'ed combination of events. 

Prestore 

Specifying Prestore in your storage qualifier definition causes the trace 
function to store up to two instruction fetch cycles preceding the qualified 
condition being stored. This lets you view the instructions leading up to the 
qualified state. 



See Also Trace StoreQual 

Trace StoreQual List 
Trace StoreQual None 



Examples To store only states matching event 1 defined with the Trace Event Specify 

command and the last two instruction fetches preceding each of these states: 

Trace StoreQual Event 1 <Tab> Prestore 
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To store only states matching event 1 or event 2 defined with the Trace Event 
Specify command: 

Trace StoreQual Event 1 <Tab> Or 3 
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Trace StoreQual List 



Trace ) ^ StoreQual ) ^ List 



<Return> 



The Trace StoreQual List command displays the current storage qualification 
definition in the View window. 



See Also Trace StoreQual 

Trace StoreQual event 



Examples To list the current storage quaUfication definition in the View window: 

Trace StoreQual List 
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Trace StoreQual None 



Trace StoreQual ^ -(^ None ^ 



<Return> 



The Trace StoreQual None command causes tlie trace function to store all bus 
cycles (no trace qualitication). 



See Also Trace StoreQual 

Trace StoreQual event 



Examples To store all bus cycles (no trace qualification): 

Trace StoreQual None 
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Trace Trigger 



C Trace Trigger 



Address 



Not 



<addr_spec> 





<Tob> 









Not 



<doto_spec> 



<Tob> 



Not 



Re 



od y 



^^-(' Write 



Size ^ — »{ Byte 

he 



Word 



'^- ^ 3Byte~ 
Long 



^-»( FnCde — >( Doto 



Prog 



'^-' ^ Supr 
^—(^ User 



CycTyp ^ 



CPU 



BrkOnTrg 



<Return> 



Pos 



nTrig ^ 



— < ^ Stort ^ 
^ Center ^ 
End 
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The Trace Trigger command specifies the bus conditions to be used as the trigger 
condition. Bus conditions may be address values, data values, or status values. 
When you define a trigger, you are essentially defining an event. You can also use 
the Tra ce Even t Specify command to define an event, and then use the 
Trace Trigger Event command to use the specified event as the trigger 
event. 

Trigger conditions 

Three types of conditions can be specified in triggers. The three condition types are: 

Address The value that appears on the address bus 

Data The value that appears on the data bus 

Status The type of bus activity, for example, instruction fetch, read, 

write, interrupt acknowledge, etc. 

If you use the keyword Is, bus cycles matching the specification that follows are 
used as the trigger event. If you use the keyword Not, the trigger is defined as the 
logical NOT of the specification that follows, that is, any bus cycle that does not 
match the specification is the trace trigger. For example, if you enter the 
specification: 

Trace Trigger Address Is 0xl0b6 . . 0xl23d 

the trigger is defined to be any address in the range 0xl0b6 through 0xl23d. If you 
enter the specification: 

Trace Trigger Address Not OxlObG . . 0xl23d 

the trigger is defined to be any address outside the range 0xl0b6 through 0xl23d. 

Address and data values 

Address values (<addr_spec>) and data values i<data_spec>) are specified 
as 32-bit values or a range of 32-bit values denoted by (..). You can specify address 
values using module names, symbols, and high-level hue numbers. See the 
"Expressions and Symbols in Debugger Commands" chapter for detailed 
information on how to specify addresses. 

A mask can be used to specify a range with a 32-bit value that marks valid bits in 
addresses or data. For example, to trigger only on addresses in the range 
OxOOOOlSxx (where xx are "don't care" values), you could enter the command: 
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Trace Trigger Address Is 
0x1500 &= OxffffffOO 

where is the bit mask operator. 



Note Execute the Debugger Execution Environment SyncSIMcommand 

before specifying an event with an address to ensure that the analyzer interprets the 
chip selects properly for the address. See the description of the Debugger 
Execution Environment SyncSIMcommand. 



Status values 

Status conditions are the types of bus activities you wish to specify. The following 
keywords are used to specify the status condition: 



Read specifies read operation 

Write specifies write operation 

Size specifies access size (byte, word, 3 byte, or long) 

FnCde specifies function code ( data or program, supervisor or user 

mode) 

CycTyp specifies cycle type (fetch, CPU, or DMA) 



Addresses specified witha a CycTyp of Fetch wiU be masked to the size specified 
by Debugger Option Trace Fetch_Align. 

Breaking on triggers 

Enter the BrkOn Trg keyword to cause the user program to halt when the trigger 
term is detected. 

Trigger position 

Enter the Posn Tri g keyword to specify the position of the trigger condition in 
the trace buffer. You can specify the trigger position to be one of the following: 

Start The trigger is at the start of the trace buffer. 
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Center The trigger is centered in the trace buffer. 

End The trigger is at the end of the trace buffer. 

The trigger state will always be Une number 0 in the trace Ust. 

Interaction with trace commands 

The Trace Trigger, Breakpt Access, Breakpt Read, and Breakpt Write commands 
all require use of emulation analyzer resources. If access breakpoints are active 
(indicated by the message TRC : BrkRWA on the status line), then a Trace Trigger 
command may not be entered. If a trace trigger is active, access breakpoints may 
not be entered. 

The Breakpt commands set up a trace with the trigger at the end of the trace buffer, 
using the current storage quaUfication. You can display the trace after the break 
occurs to see the cycles leading up to the break. 

See Also Breakpt Access 

Breakpt Read 
Breakpt Write 
Trace Trigger Event 
Trace Trigger List 
Trace Trigger None 
Debugger Option Trace Fetch_Ahgn 



Examples To trigger the trace measurement on entry into function 

update_state_of_system and position the trigger state in the center of the 
trace memory buffer: 

Trace Trigger Address Is update_state_of_systein <Tab> 
Status Is PosnTrig Center 

To trigger the trace measurement on the occurrence of a write to variable 
time_struct. seconds, and halt (break) program execution on detection of the trigger 
condition: 

Trace Event Specify 6 <Tab> Address Is 

&time_struct . seconds <Tab> Data Is 0x3c Status Is Write 
<Tab> BrkOnTrg 
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Trace Trigger Event 




<Return> 



The Trace Trigger Event command lets you specify an event or combination of 
events defined with the Trace Event Specify command as a trigger 
condition. The trigger condition can be a single event, a logically OR'ed 
combination of events, a specified number of occurrences of an event or 
combination of events, or a sequence of the preceding conditions. The complexity 
of the specification is hmited by the analyzer. 



Event Number 

Each event that you define using the Trace Event Specify command is assigned an 
event number between 1 and 30. This number (<event_imibr>) is used to assign an 
event to be a trigger term. 



504 



Chapter 12: Debugger Commands 
Trace Trigger Event 



Keywords 

Or 

Count 



Then 

BrkOnTrg 

PosnTrig 



The Or keyword lets you specify a logically OR'ed 
combination of events as the trigger condition. 

The Count keyword specifies the number of times 
(<nmbr_times>) an event or OR'ed combination of events 
must occur before the debugger proceeds to the next trigger 
sequence term or before the trigger condition is completed. 
<nmbr_times> must be a value in the range of 1 to 65535. 

The Then keyword lets you specify a sequence of terms in the 
trace specification. 

The BrkOn Trg keyword causes the user program to halt when 
the trigger term is detected. 

The Posri Trig keyword is used with the Start Center, and 
End keywords to specify the position of the trigger condition in 
the trace buffer. 



Start 



Center 



End 



The Start keyword specifies the start of the trace buffer as 
the trigger position. 

The Center keyword specifies the center of the trace buffer as 
the trigger position. 

The £/id keyword specifies the end of the trace buffer as the 
trigger position. 



The trigger state will always be Une number 0 in the trace Ust. 



See Also 



Trace Trigger 
Trace Trigger List 
Trace Trigger None 



Examples 



To trigger on the occurrence of event 1 which has been previously defined with the 
Trace Event Specify command: 

Trace Trigger Event 1 
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To trigger on the occurrence of either event 1 or event 3 (events 1 and 3 must have 
been previously defined with the Trace Event Specify command): 

Trace Trigger Event 1 <Tab> Or 3 

To trigger on the fifth occurrence of event 3 following an occurrence of event 1 
(events 1 and 3 must have been previously defined with the Trace Event Specify 
command): 

Trace Trigger Event 1 <Tab> Then 3 <Tab> Count 5 
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Trace Trigger List 

Trace ^ ^ Trigger ^ List ^ 



<Return> 



The Trace Trigger List command displays the current trigger definition in the View 
window. 



See Also Trace Trigger 

Trace Trigger List 
Trace Trigger None 



Examples To list the current trigger definition in the View window: 

Trace Trigger List 
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See Also 



race 



Trace Trigger Never 



•{^ Trigger ^ Never ^ <Return> 



The Trace Trigger Never command sets the trace function up to collect states until 
you stop the trace using the Trace Halt command. Collection starts on the next 
program run or step command. 



Trace Halt 



Examples To collect states continuously until the trace is stopped using the Trace Halt 

command: 

Trace Trigger Never 

Collection starts on the next program run or step command. 
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Window Active 




<Return> 



The Window Active command activates the specified window. The border of the 
active window is highlighted. The Code window is active by default within the 
high level and low level screens. 
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The Next and Previous parameters specify the next higher-numbered or 
lower-numbered window relative to the active window. 

The cursor keys and the F4 function key only operate in the active window. 

The Error, Help, and Status windows cannot be made active. 

See Also Window Cursor 

Window Delete 
Window Erase 
Window New 
Window Resize 
Window Screen_On 
Window Toggle_View 



Examples To make the high-level Backtrace window active: 

Window Active High_Level Backtrace 

To make the assembly Code window active: 
Window Active Assembly Code 

To make user window 57 active: 
Window Active User_Window 57 



510 



Chapter 12: Debugger Commands 
Window Cursor 



Window Cursor 



Window )—-( Cursor 



<user window nnnbr> 



<tab> 



Position 



<line,col> 



<Return> 



The Window Cursor command sets tlie cursor position in the window specified by 
<user_window_nmbr>. The top left comer of the window is represented by 
coordinates 0,0. 

Subsequent output to the window begins at the cursor position. 

Only user-defined windows and the standard I/O window (window No. 20) may be 
specified with this command. 



See Also Window Active 

Window Delete 
Window Erase 
Window New 
Window Resize 
Window Screen_On 
Window Toggle_View 



Examples To move the cursor to line 5, column 22 in the Stdio window: 

Window Cursor 20 Position 5,22 

To move the cursor to line 3, column 0 in user window 57: 
Window Cursor 57 Position 3,0 
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Window Delete 



C 



Window 




Delete 





<Return> 



<user window nnnbr> 



The Window Delete command removes a window (possibly a screen) defined 
previously with the Window New command. Remove a window by entering the 
window's associated window number. If you do not specify a window number or if 
you specify 0, the active window is removed. 

Remove screens by removing all windows associated with that screen. For 
example, if a user-defined screen has three windows and you delete all three 
windows, the screen will be deleted as well. See the "Displaying Screens" and 
"Displaying Windows" sections of the "Viewing Code and Data" chapter for more 
information about window and screen numbers. Predefined debugger windows and 
screens cannot be removed. 

Files opened with the File User_Fopen command may also be closed with this 
command. 



File Window_Close 
Window Active 
Window Cursor 
Window Erase 
Window Open 
Window Resize 
Window Screen_On 
Window Toggle_View 



See Also 



File User_Fopen 



Example 



To delete user window 57: 



Window Delete 57 
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Window Erase 



window ^ -{^ Erase 





<Return> 





<user window nnnbr> 



The Window Erase command clears all displayed information in the specified 
window. It then places the cursor in the specified window to the 0,0 position. If you 
do not specify a window number or if you specify 0, the active user-defined 
window is cleared. Only user-defined windows and the standard I/O screen 
(window No. 20) can be cleared. This command is primarily for use within macros. 



See Also 



Window Active 
Window Cursor 
Window Delete 
Window New 
Window Resize 
Window Screen_On 
Window Toggle_View 



Examples 



To clear all displayed information in the Stdio window: 

Window Erase 20 



To clear all displayed information in user window 57: 
Window Erase 57 
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Window New 



Window New 



<user window nnnbr> 



<tab> 



High_Leve?)_ 



Assennbly 



Stdio 



User Screen )— »- <screen nmbr> 



<tab> 



Bounds 




<top_row,left_col,bottom_row,right_col> — " <Return> 



The Window New command makes (creates) new windows and screens. It may 
also be used to move existing windows to a new location within a screen. 
Windows must be assigned a number between 50 and 256 inclusive. Numbers 1 
through 49 are reserved for predefined debugger windows. The bounds parameter 
specifies both the window size and location on the screen. 



Window coordinates 0,0 correspond with the upper-left comer of the screen. 



Note When making new window, be careful not to enter coordinates that will result in a 

window that will cover the status line and command line. 

On a standard 80-column by 24-row terminal display, a row coordinate may be 
between 0 and 23. However, creating a window whose bottom row coordinate is 
greater than 18 will cause part or all of the status Une to be covered. 
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Command Parameters 



Definition of the Window New command parameters are as follows: 



Parameter 


Definition 


Range 


<user_window_nmbr> 
<user_screen_nmbr> 
<top row> 
<left col> 
<bottom row> 
<right col> 


Window ntunber 

User_Screen 

Upper row coordinate 

Left coliunn coordinate 

Lower row coordinate 

Right column coordinate 


50 to 256 inclusive 
4 to 256 inclusive 
0 to N-1 inclusive 
0 to N-1 inclusive 
0 to N-1 inclusive 
0 to N-1 inclusive 


N is the number of rows or columns on your display. The value of N is dependent on display type. 



Note The Window New command will fail if row or column coordinates are greater than 

the screen boundary. For example, the command Window New 1 5 Assembly 
36,1,39,80 will fail if you have an 80 column by 40 row screen. The command 
Window New 15 Assembly 36,0,39, 79 will work. 



Alternate Window Views 

To create alternate views of a user-defined window, follow the procedure outlined 
below. 

1 Execute the Window New command to define a window with specific size 
parameters. 

2 Execute the Window Toggle_View command, or press function key F4. 

3 Execute the Window Resize command to redefine the previously defined 
window with new size parameters. The new size parameters must be smaller 
than the previously assigned parameters. 



See Also Expression Fprintf 

File User_Fopen 
Window Active 
Window Cursor 
Window Delete 
Window Erase 
Window Resize 
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Window Screen_On 
Window Toggle_View 



Examples To make a new user window, number it 57, and display it in user screen 4 with 

upper-left corner at coordinates 5,5 and the lower right comer at coordinates 18,78: 

Window New 57 User_Screen 4 Bounds 5,5,18,78 

To make a new user window, number it 55, and display it in the high-level screen 
with upper-left comer at coordinates 5,5 and the lower right comer at coordinates 
10,20: 

Window New 55 High_Level 5,5,10,20 

To move the high level status line window to the top of the display in the standard 
interface: 

Window New 5 High_Level 0,0,3,78 

For this command to execute, the high-level window must be displayed and the 
difference between the bottom row coordinate and top row coordinate (3 - 0) must 
equal three (3). You cannot move the status line if you are using the graphical 
interface. 
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Window Resize 



Window ) K Resize 



<Return> 



The Window Resize command lets you change the size and position of the active 
window interactively. The cursor keys (left, right, up, and down arrows) move 
either the top left corner, or the bottom right corner of the window. 

To reposition the top left corner, press T and position the top left corner of the 
window using the cursor control keys. 

To reposition the lower right comer of the window, press B and use the cursor 
control keys to position the lower right comer. 

To move the window without resizing it press M and use the cursor control keys to 
move the window on the screen. 

Press the Return key to save the new coordinates. 

Press CTRL C or Esc Esc to restore the previous coordinates. 

If an altemate window view is selected, the size alterations are made to the 
altemate view. 



Note The Window Resize command can be used to alter the size of any existing window, 

including the predefined debugger windows, with the exception of the Status Line 
or View window. In the standard interface (but not in the graphical interface), the 
Status Line window can be moved or resized using the Window New command. 



See Also Expression Fprintf 

File User_Fopen 
other Window commands 
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Window Screen On 



^ Window ^ -^Screen_On^ 



►(^H;gh_Leve?)- 
►(^Assembly 



Stdio y 



U ser Scree 



<screen nmbr> 



<Return> 



The Window Screen_On command displays the selected screen. You can also use 
function key F6to display a screen. 

If the high level screen is displayed, the debugger is placed in the high level mode. 
Likewise, when you display the assembly level screen, the debugger is placed in 
the low level mode. 



See Also 



Window Active 
Window Cursor 
Window Delete 
Window Erase 



Window New 
Window Resize 
Window Toggle_View 



Example 



To activate the Assembly-level screen and place the debugger in low level mode: 
Window Screen_On Assembly 
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Window Toggle_View 



^ Window ^ — - ^Toggle_View ^ 



>(^High_Level^ 



Assembly ^ 



Breakpoint ^ 



■c 



view 



Stdio 



> 
> 



■0 



User_Window 



> 



■{^ Code J- 



^^^acktroce \- 

> 



Journal 



^ — Monitor ^ 
— Code ^ 



Stack 



Monitor 



Journal 



Registers 



<user_window_nmbr> 



<Return> 



The Window Toggle_View command selects the alternate view of a window. 
Typically, this is an enlarged view of the window. If you do not specify a window 
number or if you specify 0, the active window is the default. 



When you execute the Window Toggle_View command, the display alternates 
between the two views of the window. 
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You can also use the F4 function key to alternate views of the active window. 

To create alternate views of a user-defined window, follow the procedure outlined 
in the Window New command description. 

See Also Window Active 

Window Cursor 
Window Delete 
Window Erase 
Window New 
Window Resize 
Window Screen_On 



Examples To display the alternate view of the active window: 

Window Toggle_View 

To display the alternate view of the high-level Code window: 
Window Toggle_View High_Level Code 

To display the alternate view of user window 57: 
Window Toggle_View User_Window 57 
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Expressions and Symbols in 
Debugger Commands 

A description of the expressions and symbols you can use in debugger commands. 



Chapter 13: Expressions and Symbols in Debugger Commands 



Expressions and Symbols in Debugger Commands 

This chapter discusses the following language elements used in debugger 
commands: 

• Expression elements. 

• Formatting expressions. 

• Symbohc referencing. 

Debugger commands use standard C operators and syntax. This chapter describes 
the elements of C expressions and how expressions are structured. It also discusses 
memory and variable referencing. 



522 



Chapter 13: Expressions and Symbols in Debugger Commands 

Expression Elements 



Expression Elements 

Most debugger commands require simple C expressions that evaluate to a scalar 
value. Simple C expressions are the same as standard algebraic expressions. These 
expressions evaluate to a single scalar value. Expressions consist of the following 
elements: 

• operators 

• constants 

• program symbols 

• debugger symbols 

• built-in symbols 

• macros 

• keywords 

• registers 

• addresses 

• address ranges 

• line numbers 

Debugger commands allow any legal C expression. The following paragraphs 
describe elements of C expressions used in debugger commands. 

Operators 

The debugger supports most standard C language operators and special debugger 
operators. 

C Operators 

C operators include arithmetic operators, relational operators, assignment 
operators, and structure, union, and array operators. The following table lists these 
operators in order of precedence (first line of the table is the highest precedence). 
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Supported C Operators 



Operators Order of Association 



( ) [ ] -> . Left to right 

~ ! ++ — sizeof (type) - * & Righttoleft 

* / % Left to right 

+ - Left to right 

<< >> Left to right 

<<=>>= Left to right 

== ! = Left to right 

& Left to right 

Left to right 

I Left to right 

& & Left to right 

I I Left to right 

= += -= *= /= %= &= ^= 1= «= »= Righttoleft 

, , Left to right 



C++ Operators 

The debugger also supports C-h- operators: ::, ., ->, and &. 
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Debugger Operators 




The debugger uses some characters as special debugger operators. These debugger 




operators and their descriptions are Usted in the following table: 


Debugger Operators 


Operator 


Description 


[] 


References the contents of a memory location. For example: 




Expression Display_Value [0x20b0] 


# 


Identifies a line number. For example: 




Program Run Until #82 


@ 


Identifies a stack level, reserved symbols, or symbol tree root. For example: 




Program DisplaY_Source @2 




(stack level) 




Expression Display_Value @module 




( reserved symbol) 




Symbol Display Default @ecs\\ 




(symbol tree root) 




Identifies a character constant. 




Identifies a character string constant. 


\ 


Qualifies a symbol reference. For example: 




Program Run Until updateSys\#20 


W 


Specifies an executable file as the root of a symbol tree. The specified file must be loaded 




into the debugger. For example: 




Program Context Set @ecs\\main 
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Constants 

A constant is a fixed quantity. Constants may be integers, floating point values, or 
character string constants. 

Integer Constants. 

An integer constant may be defined as a sequence of numeric characters optionally 
preceded by a plus or minus sign. If unsigned, the debugger assumes the value is 
positive. 

Positive integer constants may range between 0 and 2**31-1. When a constant is 
negative, its two's complement representation is generated. Negative integer 
constants may range to -2**31. 

Constants can be specified as binary, decimal, or hexadecimal values. This is done 
by placing a prefix or suffix descriptor before or after the constant. The following 
table lists the legal prefixes or suffixes that may be specified with integer constants 
to denote a specific base. 



Integer Constant Prefixes and Suffixes 


Constant 


Prefix Suffix 


Base 


Digit 


Type 


Descriptor Descriptor 






Binary 


b,B 


2 


0-1 


Decimal 


t, T 


10 


0-9 


Hexadecimal 


Ox,OX h, H 


16 


0-9, A-F, a-f 



Hexadecimal constants starting with the letters A through F (or a through f) must 
be prefixed with a zero. Otherwise, the debugger attempts to interpret the value as a 
symbol name. 



By default, the debugger interprets integer constants as decimal values. The 
"Configuring the Debugger" chapter describes how to change the default radix for 
assembly-level values. 



Note You caimot use binary numbers when the radix is hexadecimal. 



The debugger truncates values larger than that which can be contained in an 
element of an expression or command. The debugger extends values less than that 
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allowed in the element. The trancation and extension are both implemented 
according to the rules of C. 

The examples given in the following table show the use of prefix and suffix 
descriptors. 



Prefix and Suffix Descriptor Examples 



Constant 


Decimal Mode 


Hexadecimal Mode 


73T 


Decimal 


Decimal 


OEFFlh 


Hexadecimal 


Hexadecimal 


10b 


Binary 


Hexadecimal 


0x2214 


Hexadecimal 


Hexadecimal 


23C3 


Illegal 


Hexadecimal 


123 


Decimal 


Hexadecimal 



Floating Point Constants 

The debugger represents floating point constants internally in standard IEEE binary 
format. All floating point calculations follow the rules of C. The debugger treats 
aU floating point constants as double precision values internally. 

Floating point constants specified on the debugger command line must have the 
following syntax: 

[sign] integer_part[fractional_part] [exponent] 

where sign is an optional plus (+) or minus (-) sign. 

integer jjart consists of one or more decimal digits. 
. is a decimal point. 

fractional _part may be zero or more decimal digits. 

exponent is an optional exponent, which is letter E (or e) 
followed by an integer part. 

When specifying a floating point constant, the debugger uses a more restrictive 
syntax than the C language. The debugger always requires an integer part and a 
decimal point. 
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Examples: 



76.3e-l 
76.3E+0 
76.3E2 



76.3 
76. e5 
76. 



-0.3el 
0.3 
0. 



Character Strings and Cliaracter Constants 

Character Strings. A character string is a sequence of one or more ASCII 
characters enclosed in double quotation marks or two or more characters enclosed 
in single quotes. If the string has more than one character, subsequent ASCII 
characters are stored in consecutive bytes. 

When a character string is referenced in a C expression, the debugger substitutes an 
address pointer to the string in the expression. 

Character Constants. A character constant is a single character enclosed in 
single quotation marks. 

When a character constant is referenced in a C expression, the debugger substitutes 
the actual ASCII character value in the expression, not the address of the character. 

You can use #define constants in debugger expressions if your compiler places the 
constant in the absolute file. 

Non-printable characters. Some non-printable characters may be embedded in 
both character strings and character constants enclosed in double quotation marks 
(") by using the escape sequences listed in the table which follows. Escape 
sequences are indicated by a backslash (\). 

The backslash is interpreted as a character in character strings enclosed in single 
quotation marks ('). 

Any characters other than those listed in the following table are interpreted literally 
if preceded by a backslash. For example, to have literal double quotation marks in 
a string, enclose the string in double quotation marks and use the escape sequence 
for double quotes shown above. For example: 

"This is a \"string\" using embedded double quotation 
marks " 

To have literal single quotation marks in a character string, enclose the string in 
double quotation marks. For example: 

"This is a string that's using a single embedded 
quotation mark" 
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Non-Printable Character Escape Sequences 


Sequence 


ASCn Name 


Hex Value 


Description 


\b 


BS 


08 


Back Space 


\f 


FF 


OC 


Form Feed 


\ii 


NL 


OA 


New Line 


\r 


CR 


OD 


Carriage Return 


\t 


HT 


09 


Horizontal Tab 


\" 




22 


Double Quote 


W 


\ 


5C 


Backslash 


\xnumber 




xnumber 


Hex Character Value 



\xnumber must be entered in the format Venn where nn is a two digit hexadecimal value. For example: 
\xOf,not \xf 



Note The debugger automatically terminates character strings enclosed in quotation 

marks with a nuU character. However, when you use a character string with a 
Memory Assign or Memory Block_Operation (Fill, Search, or Test) command, the 
debugger uses only the characters within the quotation marks (null characters are 

not added). 
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Symbols 

A symbol (also called an identifier) is a name that identifies a location in memory. 
It consists of a sequence of characters that identify program and debugger 
variables, macros, keywords,registers, memory addresses, and hne numbers. 

Symbols may be up to 40 characters in length. The first character in a symbol must 
be alphabetic, an underscore (_), or an at sign (@). The characters allowed in a 
symbol include upper and lower case alphabetic characters, numeric characters, 
dollar signs {$), at signs (@), or underscores (_). No other characters may be used 
in symbols. The debugger differentiates between upper case and lower case 
characters in a symbol. 

The following sections describe the different categories of symbols used by the 
debugger. 

Program Symbols 

Program symbols are identifiers associated with a source program. They consist of 
symbolic variable data names and function names that the programmer defined 
when writing the source program. All symbols that were defined in the source 
program can be passed to the debugger and referenced during a debugging session. 
Note that preprocessor names are not symbols. 

The compiler includes all program symbol information in the resulting output 
object module file by default. When you load an executable file for debugging, the 
debugger places all program symbols into the debugger symbol table by default. 
The debugger preserves symbol types and tteats the symbols according to their 
type. 

The debugger may be instructed to load only global symbols at load time, loading 
local symbols as they are referenced. This behavior is known as symbols on 
demand. Refer to the description of the Debugger Option General Demand_Load 
command in the 'T)ebugger Commands" chapter for more information on symbols 
on demand. 

Normally, the compiler prefixes a leading underscore to all global program 
symbols. This is done to distinguish program symbols from reserved assembler 
names. If the debugger has loaded all symbols, two symbols will be available; the 
high-level symbol (for example, main), and its low-level counterpart(_majn). 
However, with symbols on demand, only the high-level symbol is available (main). 
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Debugger Symbols 

Debugger symbols can be added during a debugging session using the Symbol Add 
command. The debugger treats debugger symbols as global symbols. When you 
create a debugger symbol, you must assign it a name. You may optionally assign it 
a type. An initial value may also be given to a debugger symbol. If you do not 
specify an initial value, the initial value defaults to zero. 

Debugger symbols are stored in the debugger's memory and are not associated 
with the processor target memory. 

Macro Symbols 

You can use macros to: 

• Create complex user commands. 

• Patch your source code temporarily. 

• Display information in user-defined windows. 

A macro is similar to a C function. It has a name, return type, optional arguments, 
optional macro local symbols, and a sequence of statements. 

There are two types of macro symbols: 

• Macro names. 

• Macro local symbols. 

Macro Names 

Macro names identify a macro. You assign macro names with the Debugger 
Macro Add command. 

Macro Local Symbols 

Macro local symbols are local variables and parameters defined within macros. 
They are declared when you create a debugger macro with the Debugger Macro 
Add command. A macro local symbol can be accessed only by the macro in which 
it is defined. It is created when the macro is executed. The macro local symbol has 
an undefined initial value. 
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Reserved Symbols 

Reserved symbols are reserved words that represent processor registers, status bits, 
and debugger control variables. These symbols are always recognized by the 
debugger. You can use reserved symbols any time during a debugging session. 
Reserved symbols have special meanings within the debugger command language. 
They cannot be defined and used for other purposes. To avoid conflict with other 
symbols, the names of all reserved symbols begin with the "@" character. 

The debugger can generate a list of all reserved symbols (see page 138). In 
addition, many of the reserved symbols are listed in the "Registers" chapter. 

Line Numbers 

Line numbers can be used to refer to lines of code in your original source program. 
The compiler generates Une numbers by default. 

Line number references must be preceded by a pound sign (#). For example: 
Program Run Until #82 

When you refer to a source line number, the debugger translates it to the address of 
the first instruction generated by the compiler for that C statement. If a C source 
line did not generate executable code, a reference to that hne number actually 
refers to the next line that did generate executable code. 

To reference a line number that is in a module other than the current one, precede 
the line number with a module name. For example: 

Breakpt Instr updateSYs\#332 

If supported by your compiler, you can debug multiple statements on one line. A 
dot qualifier (.) identifies the sequence of a statement on the source line. A colon 
qualifier (:) identifies a column number within the source line. Hewlett-Packard 
cross assemblers do not support multi-statement debugging. 
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Addresses 

An address may be represented by any C expression that evaluates to a single 
value. The C expression can contain symbols, constants, Une numbers, and 
operators. 

Code Addresses 

Code addresses refer to the executable portion of a program. In high level mode, 
expressions that evaluate to a code address cannot contain numeric constants or 
operators. 

Data and Assembly Level Code Addresses 

Data addresses refer to the data portion of a program. Data address and assembly 
level code address expressions may be represented by most legal C expressions. 
There are no restrictions on constants or operators. 

Address Ranges 

An address range is a range of memory bounded by two addresses. You specify an 
address range with a starting address, two periods (..), and an ending address. 
These addresses can be actual memory locations, line numbers, symbols, or 
expressions that evaluate to addresses in memory. 

You can also specify a byte offset as the ending address parameter. If you specify 
a byte offset, the debugger adds the specified number of bytes to the starting 
address and uses the resulting address as the ending address. You must precede a 
byte offset with a plus sign (+). 

You may specify module names before symbols and line numbers to override the 
default module. 

The following examples show how to specify address ranges. 

To set instruction breakpoints starting at Une number 80 and ending at Une number 
90: 

Breakpt Instr #80.. #90 
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To display code as bytes starting at line number 82 and ending at address lOdO 
(hex): 

Memory Display Byte #82..0xl0d0 

To display code as bytes, starting at memory location tickjclock and ending at 20 
bytes past tick_clock: 

Memory Display Byte tick._clock: . . +2 0 
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Keywords 



Keywords are macro conditional statements that can be used in a macro definition. 
These keywords are very similar to the C language conditional statements. You 
cannot redefine keywords or use them in any other context. The debugger 
keywords are Usted below. 

IF 

ELSE 
FOR 
WHILE 
DO 

BREAK 

CONTINUE 

RETURN 
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Forming Expressions 

The debugger groups expressions into two classes: 

• Assembly language expressions used in assembly level mode. 

• Source language expressions used in either assembly level mode or high level 

mode. 

When you use a source language expression to express a code address in high level 
mode, it can consist only of a single symbol or a single line number. Source 
language expressions cannot contain numeric constants or operators. This 
restriction reduces confusion when entering high level expressions. There are no 
restrictions on source language expressions that evaluate to data addresses or on 
assembly language expressions. 

Examples of legal and illegal source language code expressions in high level mode 
are shown below. 

Legal #80 
main 

Illegal #80+3 

main+10 

With several commands, the size of an expression can be specified by size 
qualifiers. The size qualifiers are explained in the "Debugger Commands" chapter. 

You may use C++ classes in expressions. 

Floating point calculations follow the rules of C. Single precision numbers are 
converted to double precision, the specified operation is done, and the result is 
translated back to single precision. 



Note Any value can be treated as an address. For example, a character value G'yte) can 
be treated as an address. You should be careful when using values as addresses. 



Examples of vahd expressions are shovm in the following table. 
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Valid Expressions 


Expression 


Meaning 


#7 


Line number reference (code address) 


i 


Symbol reference (value or address) 


x+(y*5) 


Arithmetic operation (value or address) 


def ault_targets [2] 


Array reference (value or address) 


assign_vectors 


Function name reference (code address) 






Expression Strings 




An expression string is a list of values separated by commas. The expression string 




can contain expressions and ASCII character strings enclosed in quotation marks. 




For several commands, each value in an expression string can be changed to the 




size specified by the size qualifiers. If you change the size, the debugger pads 




elements that do not fit evenly. Examples of expression strings are shown in the 




following table. 


Expression String Examples 


String 


Results 


l,2,"abc" 


Values 1 and 2, and ASCII values of abc. 


3+4, time, maclQ 


Value 7, value of time, results of calling the macro 'macl'. 


'lxyzl23' 


ASCn values. 
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Symbolic Referencing 

The debugger references symbols in a different manner than the standard C 
language definition. Therefore, understanding how variables are allocated and 
stored in memory is important. The following sections describe symbol storage 
classes and data types. These sections are followed by a discussion on: 

• Referencing symbols with root, module, and function names. 

• Making stack references. 

In the following paragraphs, the notion of a 'module' is synonymous with a file in 
C. In fact, the module name is simply the basename of the source file with no 
suffix. 

Storage Classes 

All variables and functions in a C source program have a storage class that defines 
how the variable or function is created and accessed. The storage classes are: 

• extern (global) 

• static 

• automatic 

• register 

C preprocessor symbols are not available to the debugger. The following 
paragraphs describe each storage class used in a C source program. 

Extern (global) 

Global variables in a C program are declared outside of a function and are 
accessible to all functions. Storage for these variables is allocated only once. 
Thereafter, references are made to the previously allocated space. 

Global functions can be called from any other function. 

Static 

Static variables in a C program are allocated permanent storage and can be local to 
a module or local to a function. 
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In C, static variables local to a module can only be accessed by functions in that 
module. In the debugger, static variables local to a module can be accessed either 
when a function is active in that module or when the variable is qualified by the 
module name in which it is defined. A static variable that is local to a function can 
only be accessed by the function in which it was declared, unless it is qualified by 
the module and function in which it is defined. 

Static functions can only be accessed when the function is in the current module, 
unless the function is qualified by the module in which it is defined. 

Automatic 

Automatic variables are declared inside a function and are accessible only to that 
function. Storage for these variables is allocated on the stack when the function is 
called and released when the function returns. Automatic variables do not have an 
initial value (their values are not retained between function calls). 

You can access an automatic (local) variable when it is local to the current 
function, or when its function is on the stack. Use the stack-level prefix 
@<stack_level> to access an automatic variable in a function on the stack. 

Register 

Register variables are also declared inside a function and are accessible only to that 
function. Storage for these variables is allocated in a specific hardware register 
when the function is called and released when the function returns. Register 
variables do not have an initial value (their values are not retained between 
function calls). 

A register variable is accessible when it is local to the current function, or when its 
function is on the stack. 



Note Breakpoints cannot be set on accesses to register variables. If you need to set 

breakpoints on a variable, make sure that it is allocated on the stack by declaring its 
type as automatic. 



Data Types 

All symbols and expressions have an associated data type. Assembly language 
modules may contain variables with the types BYTE, WORD, or LONG. The 
debugger treats these types as unsigned char, unsigned short int, and unsigned long. 
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respectively. A segment attribute indicates whether a variable was defined in a 
code segment or a data segment. 



Source language modules may contain any valid C language data type. The data 
types for each type of module are listed in the following tables. The ranges of 
values are decimal representations. 



Assembly Level Data Types 


Type 


Size 


Range 


BYTE (unsigned char) 
WORD (unsigned short int) 
LONG (unsigned long) 


8 bits, unsigned 
16 bits, unsigned 
32 bits, unsigned 


0 to 255 

0 to 65535 

0 to 4294967295 




High Level Scalar Data Types 


Type 


Size 


Range 


char 

unsigned char 
short int 

unsigned short int 
int 

unsigned int 
long 

unsigned long 

enum 

pointer 

float 

double 


8 bits, signed 
8 bits, unsigned 
16 bits, signed 
16 bits, unsigned 
32 bits, signed 
32 bits, unsigned 
32 bits, signed 
32 bits, unsigned 
8-32 bits, unsigned 
32 bits, unsigned 
32 bits 
64 bits 


-128 to 127 
0 to 255 

-32768 to 32767 
0 to 65535 

-2147483648 to 2147483647 
0 to 4294967295 
-2147483648 to 2147483647 
0 to 4294967295 
0 to 4294967295 
0 to 4294967295 
1.18x10"^^ to 3.4x10""^^ 
9.46x10-^*^^ to 1.79x10""^°^ 
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High Level Complex Data Types 


Type 


Size 


struct 


Combined size of members (plus possible padding) 


union 


Size of largest member 


array 


Combined size of elements 



Type Conversion 

The debugger does data type conversions under the following conditions: 

• When two or more operands of different types appear in an expression, the 
debugger does data type conversion according to the rules of C. 

• When arguments are passed to a macro function, the debugger converts the 
types of the macro's arguments to the types defined in the macro. 

• When the data type of an operand is forced by type casting, the debugger 
converts the data type. 

• When a specific type is required by a command, the value is converted by the 
debugger according to the rules of C. 

Type Casting 

Type casting forces the conversion of a debugger symbol or expression to a 
specified data type. The debugger converts the resulting value of the expression to 
the specified data type, as if the expression was assigned to a variable of that type. 
The debugger does not alter the contents of the variable. 

You can cast debugger symbols and expressions into different types using the 
following syntax: 

(typename) expression 

For example, the following symbol is cast to type char: 
(char) prime 

The following example casts the variable expression ptr char to type int: 

(int) ptr char 
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Unlike C, the debugger allows casting to an array. The following example casts 
the address of the symbol int_value to an array of four chars: 

( char [ 4 ] ) & int_value 

This type of casting to an array can be used with both the Expression 
Display_Value and Expression Monitor_Value commands. 



Special Casting 

In addition to the standard C type casts, the following assembly level casts are also 
recognized by the debugger's expression handler. 

(QS) 

This type cast coerces an expression into a quoted string. For example, assuming 
the symbol int_val has a value of 0x61626364, 

Expression Display_Value (Q S) &int_val 

causes int_val to be displayed as "abed". Note that the expression evaluates to an 
address because the (Q S) type cast is semantically synonymous with the C type 
cast (char *). 

(I A) 

This type cast coerces an expression into an instruction address. For example, 
assuming the symbol int_val has a value of 0x400, 

Breakpt Instr (I A) int_val 

sets an instruction breakpoint at address 0x400. 

(H D) 

This type cast coerces an expression into a long word (4 bytes) and displays the 
value in hexadecimal format. For example, assuming the symbol char_val has a 
value of Ox3F, 

Expression DisplaY_Value (H D) char_val 
win cause char_val to be displayed as OxOOOOOOSF. 
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(H W) 

This type cast coerces an expression into a word (2 bytes). For example, assuming 
the symbol int_val has the value 0x12345678, 

Expression Display_Value (H W) int_val 
win cause int_val to be displayed as 0x5678. 

(H B) 

This type cast coerces an expression into a byte. For example, assuming the 
symbol int_val has a value of 0x12345678, 

Expression DisplaY_Value (H B) int_val 
will cause int_val to be displayed as 0x78. 

Scoping Rules 

References to symbols follow the standard scoping rules of C. For example, if the 
symbol 'x' is referenced, the debugger searches its symbol table for 'x' using the 
following priority: 

• A variable local to the current macro (if any). 

• A variable local to the current function (if any). 

• A variable static to the current module (if any) . 

• A global variable or debugger symbol. 

Referencing Symbols 

Symbols are qualified (and therefore referenced) according to their context. 
Context in the debugger is defined by a symbol tree and, if applicable, by a module 
and function name. 

Root Names 

Within the debugger, the symbol table is represented as a hierarchical tree, with 
each level representing a scoping level. There are two types of symbol trees which 
exist within the debugger: 

• non-program symbol tree 

• program symbol tree 
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Non-program symbol tree. This tree is composed of non-program symbols. 
Only one non-program symbol tree exists. This tree is made up of: 

• debugger symbols (@PC, @SP, etc.) 

• macros 

• user-defined debugger symbols 
The root name of this tree is W. 

Program symbol tree. The second type of symbol tree is the program symbol 
tree. The debugger allows up to 30 program trees. This tree is made up of symbols 
which exist in the target program. Since there may be multiple program trees 
within the debugger, the root of a program tree is specified as @absfile\\, where 
absfile is the name of the executable file with its suffix stripped. For example, the 
root name of the program tree associated with the executable file a.out.x would be 
@a_out\\. 



Note Any embedded '.' characters in a file name are converted to underscores. This 

prevents conflicts with the '.' structure operator. For example, the module name of 
source file myfUe.bar.c would be myfile_bar. 



There is no method for generating a list of multiple program trees. 

If two or more executable files with the same name are loaded, the debugger 
appends an underscore and number to one of the files to make the root names 
unambiguous. For example, loading two a.out.x files would result in the creation 
of two program trees, with root names a_out and a_out_l. 

Whenever the PC is pointing to the code space of a program, the root name of the 
program's symbol tree is the current root. A shorthand notation for specifying the 
current root is the symbol V For example, if the debugger is invoked without 
loading an executable file, the current root would be\\ which would be 
synonymous with \. However, once an executable file (a.out.x) is loaded with the 
PC set to an address within the executable' s code space, the current root becomes 
@a_out\ which would be synonymous with\. 

The reserved symbol " @root" points to a character string representing the name of 
the current root, and the symbol "@file" points to the name of the file containing 
the current PC. These may be empty strings ("") if the PC is outside of any defined 
symbol database. 
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Symbolic Referencing 

Module Names 

The C language does not contain the concept of a module. Within the context of 
the debugger, a module is a scoping level which is identical to the scoping level of 
a file in C. Module names (which are generated by the compiler), are derived from 
source file names by removing the suffix of the source file. For example, the 
module name associated with the source file myfile.c would be myfile. Module 
names are used to qualify symbol references within the program symbol tree. 
When used as such, they are separated from any following function name by aV 



Note If files in two directories have the same name, they will have identical module 

names. Since the debugger cannot distinguish between the two modules, aU 
references will resolve to the last loaded module. 



Assembly level modules with multiple code sections. If assembly 

language modules have more than one code section, the debugger breaks the 
module down into sub-modules. For example, if the source file myfile.s had three 
code sections, the modules myfile, myfile_2, and myfile_3 would appear in the 
program's symbol tree. This module separation only affects the address ranges of 
the module, not the scoping, i.e. all symbols scoped under the file myfile.s would 
be scoped under module myfile. 

Context. Some symbol references are dependent on the current context. See the 
examples in the following tables. The current context is based on the PC and 
consists of the current root, current module, and current function. To display the 
current context, execute the command: 







Program Context 


Display Return 


Symbolic Referencing Witli Explicit Roots 


Example 






Comment 


Symbol 


Display 


Default \\ 


Display symbols scoped under the non-program 
root. 


Symbol 


Display 


Default @a_out\\ 


Display symbols scoped under the program root 
a_out. 


Symbol 


Display 


Default \ 


Display symbols scoped under the current root. 
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Example 



Symbolic Referencing With Explicit Roots 
Comment 



Symbol Display Default 
@a_out\\modl 



Symbol Display Default \modl 

Symbol Display Default 
@a_out\\modl\ 



Symbol Display Default \modl\ 
Breakpt Instr @a_out\\modl\funcl 

Breakpt Instr \modl\funcl 



Symbol Display Default 
@a_out\\modl\funcl\ 

Symbol Display Default 
\modl\f uncl\ 

Breakpt Access 

@ a_out \ \modl \funcl\j 



Display symbol information for module modi 
scoped under program root a_out. 

Display symbol information for module modi 
scoped under the current root. 

Display symbols scoped under module modi in 
program root a_out. 

Display symbols scoped under module modi in the 
current root. 

Set a breakpoint at the entry point to function^nci 
in module modi in program root a_out. 

Set a breakpoint at the entry point to function^wnci 
in module modi in the current root. 

Display symbols scoped under function/mci in 
module modi in program root a_out. 

Display symbols scoped under function/mci in 
module modi in the current root. 

Set a breakpoint on accesses of variable j scoped 
under function^Mnci in module modi in program 
root a out. 



Breakpt Access \modl\f uncl\ j 



Set a breakpoint on accesses of variable j scoped 
under function^Mnci in module modi in the current 
root. 



Notes: 



The variable modi must be a module name. 

The variable/wMci must be a function name. 

The example pairs are equivalent if the current root is a_out. 
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Symbolic Referencing Without Explicit Roots 



Example Comment 

Symbol Display Default x Display symbol information for all symbols named 

X at any scoping level in any root. 

Breakpt Access x Set a breakpoint at the x found using the scoping 

rules described in this chapter. 

Symbol Display Default x\ Display symbol information for global symboLr in 

the current root and all symbols scoped under x. x 
may be a variable, function, or module name. 

Breakpt Instr x\#18 Set a breakpoint at Une 18 of modules. 

Symbol Display Default x\y Display symbol information for local variable y in 

function x (or function y in module x) in the current 
context. 

Symbol Display Default x\y\ Display symbol information for local variable y in 

function x (or function y in module x) in the current 
context and for all symbols scoped under x\y. 

Breakpt Access x\y\j Set a breakpoint at local variable j in function y in 

module x in the current root. 



Evaluating Symbols 

The debugger evaluates symbols in expressions using the rules of the C language as 
follows: 

• Function names and labels evaluate to addresses. 

• Variables generally evaluate to the contents of the memory location at the 
address of the variable (the exception is unsubscripted array names which 

evaluate to addresses.) 

The examples in the following table show the differences in evaluation of these 
symbol types. 
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Symbol Evaluation Examples 


Example 


Comment 


Breakpt Instr foo 


The symbol /oo is a function name. The breakpoint 
is set at the address of foo. 


Breakpt Access &i 


i is a variable. Therefore, the debugger evaluates 
the symbol as the value of ; rather than the address 
of i. The & operator causes the breakpoint to be set 
on the address of i. 


Breakpt Access a 


a is an array. The breakpoint is set at the address of 
the first element of the array. 


Breakpt Access a [3] 


A breakpoint is set at the address specified in a[3], 
not the address of a[3]. 


Breakpt Access &a[3] 


A breakpoint is set at the address of a[3]. 



Stack References 

When a function is invoked in C, space is allocated on the stack for local variables. 
If one function calls another function, all information is saved on the stack to 
continue execution when the called function returns. The caller function is now 
nested. 

You can reference variables and functions on the stack implicitly or expUcitly. 
Implicit Stack References 

The default compiler setting allocates storage for all local variables in a C program 
in registers, if possible. Variables that cannot be stored in registers are allocated 
storage on the stack. With the debugger, you can implicitly reference variables on 
the stack as follows: 

• To refer to variables on the stack in the current function, specify the name of 
the variable. For example: x. 

• To refer to a local variable in a nested function, specify the function name 
followed by a backslash and then the name of the local variable, for example, 
main\i. 
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Explicit Stack References 

A function is allocated storage on the stack when it is executing, or when it has 
called another function. To refer to functions and variables on the stack explicitly, 
you must specify the function's nesting level preceded by a commercial at sign 
(@). The backtrace window in high-level mode displays nesting level information 
(for example, if the current function is @0, its calling function is @ 1, etc.). You 
may reference functions on the stack as follows: 

• To refer to the address that the function will continue to execute from, specify 
the function nesting level preceded by an at sign (@). For example, the 
command Program Run Until @1 executes the program until the current 
function returns to its caller. 

• To refer explicitly to a local variable in a nested function, specify the function 
nesting level followed by a backslash and then the name of the variable. For 
example, the command Expression Display _Value @3\str references the local 
variable 'str' of the function at nesting level 3. 

• To reference a function itself, enter the command Program Context Expand 
followed by a space and then the function nesting level. For example, the 
command Program Context Expand @ 7 displays all information about the 
function at the specified level for that particular invocation. This information 
includes the name of the function, the current line number, and all local 
variables in the function and their values. See the Program Context Expand 
command syntax description in the "Debugger Commands" chapter for more 
iirformation. 
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Predefined Macros 

Predefined macros are provided with the debugger. These predefined macros 
provide commonly used functions to help in debugging your program. The 
predefined macros available for your use are listed in the "Predefined Debugger 
Macros" table and are described on the following pages. 

The following predefined debugger macros provide services to the SIMIO system 
and intemal debugger functions. They are not designed for use by the debugger 
user. These names will be displayed if you check the debugger's predefined macro 
list using the Symbol Display command: 

bbaunload 

emuLspecial 

flash_erase_all 

flash_erase_sectors 

flash_prog 

hpsimio 

hp_redirect 

hpnosimio 

hpioctl 

hpeofkbd 

hpioreport 

load_config 

quit_debugger 
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Predefined Debugger Macros 


Macro 


Description 


ureaK-_iiiiu 


UlbpLdy lIliurniaLlOIl aDOUL a DreoKpuiIlL 


byte 


IVCLLllll d, UVLC Value clL LllC hUCl^lllCU aUUlC?>?> 


Call 


Call target function (not supported in this product) 


close 




L'111U._1 Ul Well U 


OCIIU a CUllJlllallU lyJ allULllCl aLLaOllCU ClllUlClvUl llllCllClL'C 


dword 


Return a long value at the specified address 


error 


uispiay error message 


fgetc 


Reads character from file 


fopen 


Open a file and associate it with a user window 


geLsyiii 


iveLurii Liie syiiiDOi associaieu. wiui oii duuress, ii any 


isalive 


Check the status of the specified symbol 


key_get 


Get (read) a key from the keyboard 


key_stat 


Check keyboard for availability of key 


memchr 


Search for character In memory 


lllClllL'll 


\_^ic<U- iiiciiiuiy uy ICO 


levy o m f^-rw t 

iiieiiicpy 


i_,opy cnoTaciers irum memory 


meinsei 


Set the value of characters in memory 


open 


^jpen a uinia me ror reacung ano/or wriiing 


pUU CUlllllldllU. 


J^daa a L'UllllllclllU. l\J UlC ClllUKlUJl ICllllllKU lillClldL'C 


read 


iveaU irum d sysLciii iiie 


readp 


jvedu. iium dn ukj port i^iiuL impiemenieu m mis pruuucL^ 


reg_str 


oei me register vaiue using me register name in me sinng 


snowverbiun 


onow LUc suiLWdic version iiuinoer lor me ueougger prouuci 


strcat 


Concatenate two strings 


strchr 


Locate first occurrence of a character in a string 


strcmp 


Compare two strings 


strcpy 


Copy a string 


stricmp 


Comparison of two strings without case distinction 


strlen 


String length 


strncmp 


Limited comparison of two strings 


until 


Run until expression is true 


when 


Break when expression is true 


word 


Return a word value at the specified address 


write 


Write to a system file 


writep 


Write to an VO port (not implemented in this product) 
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breakjnfo 

Function 

Return information about a breakpoint 
Synopsis 

int break:_info (addr) 
unsigned long *addr; 

Description 

The break_info macro returns the address and type of a breakpoint if it is called 
when a breakpoint is encountered. The macro returns the 32-bit representation of 
the breakpoint address used by the debugger and the following values for 
breakpoint type: 



-1 


The cause of the breakpoint is unknown. 


0 


A breakpoint did not cause this macro call. 


1 


The breakpoint was caused by a read from the address. 


2 


The breakpoint was caused by a write to the address. 


3 


The breakpoint was caused by an access (read/write status 




unknown) of the address. 


4 


The breakpoint was caused by an instruction breakpoint. 


Diagnostics 




None. 
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Example 

If you have the following code segment: 

main ( ) 
{ 

auto i , j , k; 

i = 1; 

j = 3; 

k = i + j; 

} 

and you execute the following command file: 

Debugger Macro Add int print_info{) 
{ 

unsigned long address; 
int reason; 

reason = break_info (Saddress) ; 

$Expression Printf "Breakpoint at %8x. Reason: %d\n", 
address, reason$; 
return (1) ; 
} 



Program Run Until main 
Program Step 

Breakpt Read &i; print_inf o { ) 
Breakpt Write &k; print_inf o { ) 
Breakpt Access & j;print_info () 
Program Run 

the debugger will display the breakpoint address and type value in the joumal 
window. 
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byte 

Function 

Return a byte value at the specified address 
Synopsis 

unsigned char byte (addr) 
void *addr; 

Description 

The byte macro returns a byte value of the memory contents at the specified 
address. The value of the expression addr is computed and used as the address. 

Diagnostics 

The byte value of the memory contents at the specified address is retumed. 
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close 



Function 

Close a UNIX file 

Synopsis 

int close ( fildes ) 
int fildes; 

Description 

The close macro closes a UNIX file. This macro is an interface to the UNIX system 
call close{ 2 ). Refer to the HP- UX Reference Manual for detailed iirformation. 

Diagnostics 

If the system call to close(2) is successful, 0 is returned. Otherwise, -1 is retumed 
and a system generated error message is written to the joumal window of the 
debugger. 

Example 

The following command file segment defines two global debugger symbols and 
includes the definition of a user-defined macro that uses close(). 

Symbol Add int infile 
Symbol Add int outfile 

Debugger Macro Add int close_files (infile, outfile) 
int infile; /* file descriptor to close */ 

int outfile; /* file descriptor to close */ 

{ 

/* close input file */ 
infile = close (infile) ; 
if (infile == -1) 

return 0; /* close failed */ 

/* close output file */ 
outfile = close (outfile) ; 
if (outfile == -1) 

return 0; /* close failed */ 

return 1; /* both files were closed successfully */ 

} 
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cmd_forward 

Function 

Send a comand to anotlier attaclied emulator interface. 
Synopsis 

int cmd_f orward (ui_id, command) 
char *ui_id; 
char *command; 

Description 

This macro sends the string command to the interface uijd. Interface ui_id will 
then interpret command as input to its command line. 

This macro provides a way for the target program to send commands to an 
emulator interface, as weU as allowing control of all interfaces from a common 
point. 

The interfaces that are currently supported are: 

Emul Emulator/analyzer interface. If several emulator interfaces 

are sharing the emulator, the command wiU be forwarded 
to the most recently started interface. 

Perf Software Performance Analyzer. 

BMS Broadcast Message Server (the Softbench Gateway). 

Debug Debugger. This sends a command back to the debugger 

you are using. 

If an interface of the type specified is currently running, the command will be 
executed there and any errors will be displayed there. 

Diagnostics 

A zero is returned if uiJd is not attached to the emulator. A one is returned if uiJd 
is attached. 
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Examples 

To start execution of an emulator interface command file at the beginning of 
sub-program mainS, enter: 

Breakpoint Instr mainS; cmd_forward ("emul", 
"inY_conimand_f ile" ) 

To provide a target function to send a command to a user interface, compile the 
following function into your target program; 

void send_conunand (ui, cmd) 
char *ui, *cmd; 

{ 

return; 

} 

Then set a breakpoint with a macro call: 

Breakpoint Instr send_cominand\@ENTRY; cmd_forward 
(ui, cmd) 

When execution reaches the first statement in send_command() the command cmd 
win be sent to user interface ui. Execution will halt if ui was not attached, and will 
continue otherwise. 
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dword 

Function 

Return a long value at the specified address 
Synopsis 

unsigned long dword (addr) 
void *addr; 

Description 

The dword macro returns a LONG (4-byte) value of the memory contents at the 
specified address. The value of the expression addr is computed and used as the 
address. 

Diagnostics 

The LONG value of the memory at that address is returned. 
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error 

Function 

Display error message 
Synopsis 

void error (level, text, parm) 
int level; 
char *text; 
long parm; 

Description 

The errorO macro is used to display error messages due to errors generated within 
macros, level must have a value of 1, 2, or 3. text is a string which can contain one 
%d format character, where parm is the associated integer value. 

level can be used to indicate the severity of the error by its value. The following 
explains the values available for level, and the associated action taken by error(). 

1 text is displayed in the journal window. 

2 text is displayed in the journal window and the macro halts program execution. 

3 An error box pops up, text is displayed within the box, and the macro halts 
program execution. 
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fgetc 

Function 

Reads character from file 



Synopsis 

int fgetc (vp_nuin) 
int vp_nuin; 



Description 

The macro fgetc() returns the next character in the file associated with the window 
number vp_num. The window number must be a result of the File User_Fopen 
command. The value -1 is returned on end of file. 
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fopen 

Function 

Open a file and associate it with a user window 
Synopsis 

int fopen (vp_nuin, filename, mode) 
int vp_num; 
char *filename; 
char *mode; 

Description 

The macro fopen() opens a file and associates it with a user-defined window. This 
macro is equivalent to the File User_Fopen debugger command, filename is the 
name of the file to be opened, mode is a string that specifies the mode in which the 
file is opened. Valid modes are: 

"r" Open file for reading only 

"w" Open file for reading and/or writing (existing file contents are 

erased) 

"a" Open file for appending 

Diagnostics 

If successful, a window number is retumed. The error code -27 indicates that the 
window is already open or that the window number is out of range. The error code 
-101 is retumed for other errors; for example, if the file to be read does not exist. 
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getsym 

Function 

Return tlie symbol associated with an address, if any exists 
Synopsis 

char *getsym (addr) 
void *addr; 

Description 

The getsym macro returns, as a character string, the symbol associated with the 
address argument. The address argument must coincide with the symbol address for 
the macro to return the symbol name; the macro will not return a symbol name if 
the symbol storage space starts elsewhere but spans the argument address. 

Diagnostics 

Retums the symbol name associated with the address, if one exists; otherwise, it 
retums a null string. 

Example 

Symbol Add foo <tab> Address 0x1000 

Expression Printf "%s", getsym (0x1000) 
foo 
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isalive 

Function 

Check the status of a specified symbol 
Synopsis 

int isalive (symbol_naine) 
void symbol_name; 

Description 

The isaUve macro can tell you whether a symbol is defined, and additionally if it 
currently active or available on the stack. 

Diagnostics 

Retums one of the following four values, depending on the status of the symbol; 

Value Meaning 

- 1 Symbol does not exist 

0 Symbol not currently active (cannot be referenced) 

1 Symbol currently active (part of the local procedure) 

2 Symbol available on the stack (not part of the local procedure) 

Example 

Symbol Add foo <tab> Address 0x1000 

Expression Printf "%i", isalive (foo) 
1 

because symbol is defined and active 
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key_get 

Function 

Get a key from tlie keyboard 
Synopsis 

unsigned short key_get() 
Description 

The macro key_get() reads a key from the keyboard. It retums only after a key is 
available. The return value is the value of the key. 
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key_stat 

Function 

Check keyboard for availability of key 
Synopsis 

unsigned short key_stat() 
Description 

The key_stat() macro checks the keyboard to see if a key is available to read. It 
returns 0 if no key is available. The first pending key is returned if any keys are 
available. 

Diagnostics 

The value -1 is returned if the macro fails. 
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memchr 

Function 

Search for character in memory 

Synopsis 

char *memchr (strl, byte_value, count) 
char *strl; 
char byte_value; 
unsigned count; 

Description 

The memchr macro locates the character byte_value in the first count bytes of 
memory saeastrl. 

Diagnostics 

The memchr macro retums a pointer to the first occurrence of character byte_value 
in the tirst count characters in memory area strl. If byte_value does not occur, 
memchr returns a NULL pointer. For debugger variables, -1 (OxFFFFFFFF) is 
retumed if byte_value does not occur. 
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memclr 

Function 

Clear memory bytes 

Synopsis 

char *memclr (dest, count) 
char *dest; 
unsigned count; 

Description 

The memclr macro sets the first count bytes in memory area dest to zero. 
Diagnostics 

The memclr macro returns dest. 
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memcpy 

Function 

Copy characters from memory 

Synopsis 

char *memcpy (dest, src, count) 
char *dest, 
char *src 
unsigned count; 

Description 

The memcpy macro copies count characters from memory area src to dest. 
Diagnostics 

The memcpy macro retums dest. 
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memset 



Function 

Set tlie value of characters in memory 



Synopsis 

char *memset (dest, byte_value, count) 
char *dest; 
char byte_value; 
unsigned count; 



Description 

The memset macro sets the first count characters in memory area dest to the value 
of character byte_value. 

Diagnostics 

The memset macro retums dest. 



571 



Chapter 14: Predefined Macros 
open 



open 

Function 

Open a UNIX file for reading and/or writing 

Synopsis 

int open (path, of lag) 
char *path; 
int oflag; 

Description 

The open() macro opens a UNIX file, returning an UNIX file descriptor, paf/j is the 
name of the file to be opened, oflag is the mode in which the file will be opened. 
The possible modes may be found in the header fUe /usr/include/fcntl.h. Some 
useful modes are: 



read only 0 

write only 1 

read/write 2 

no delay 4 

append 8 

create 256 (HP-UX) or 5 12 (SunOS) 

truncate 512 (HP-UX) or 1024 (SunOS) 



These modes may be combined be adding the appropriate values together. 

This macro is an interface to the UNIX system call open(2). Refer to the HP-UX 
Reference Manual for detailed information. 

Diagnostics 

If the system call to open(2) is successful, the system file descriptor is retumed. 
Otherwise, -/ is retumed and a system generated error message is written to the 
journal window of the debugger. 
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Example 

The following command file segment detines two global debugger symbols and 
includes the definition of a user-deiined macro that uses open(). 

Symbol Add int infile 
Symbol Add int outfile 

Debugger Macro Add int open_files (infile, outfile) 
char *infile; /* file to read from */ 

char *outfile; /* file to write to */ 

{ 

/* open input file in read only mode ^1 
infile ^ open (infile, 0); 
if (infile == -1) 

return 0; /* open failed */ 

/* create output file in read/write mode */ 
outfile = open (outfile, 258); 
if (outfile == -1) 

return 0; /* open failed */ 

return 1; /* both files were opened successfully */ 

} 
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pod_command 

Function 

Send terminal interface commands to the emulator 
Synopsis 

int pod_command { command, response) 
char *command, *response; 

Description 

The pod_comniand macro sends the string in command to the emulator, and puts 
any response text in response. If multiple lines of text are returned, the lines are 
separated in response with a new line (\n) character. If response is a null pointer 
(0), any response is ignored. 



Caution 

This macro is primarily for diagnostic purposes. Use of this macro to send terminal 
interface commands that change the state of the emulator or analyzer may produce 
unexpected and UNSUPPORTED behavior. 



Diagnostics 

If the command produces no error, this macro returns a one (1). Otherwise, the 
macro retums a zero (0) and the debugger displays the error or errors in the 
debugger error window. 

Make sure that the response string is large enough to hold any data returned from 
the emulator. Responses put into debugger variables wiU be truncated to the 
maximum length of the debugger string. The debugger will not give an error 
indication. 
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Examples 

To get the first 99 characters of emulator version information: 

Symbol Add char resp[100] 

Debugger Macro Call pod_command ( "ver " , resp) 
Expression Printf "%s",resp 

To send the emulator "help" command and ignore output: 
Debugger Macro Call pod_cominand ( "help" , 0 ) 

To send an invahd command to the emulator: 

Debugger Macro Call pod_cominand (" silly" , 0 ) 
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read 

Function 

Read from a system file 
Synopsis 

int read(fildes, buf, nbyte) 
int fildes; 
char *buf; 
unsigned nbyte; 

Description 

The read macro reads from a system file. This macro is an interface to the UNIX 
system call read(2). Refer to the HP-UX Reference Manual for detailed 
information. 

Diagnostics 

If the system call to read(2) is successful, the number of bytes read is returned. 
Otherwise, -1 is returned and a system generated error message is written to the 
journal window of the debugger. 

Example 

The following command file segment defines two global debugger symbols and 
includes the definition of a user-defined macro that uses read(). 

Symbol Add int infile 
Symbol Add int outfile 

Debugger Macro Add int foo {infile, outfile) 

int infile; /* file descriptor to read from */ 

int outfile; /* file descriptor to write to */ 

{ 

char buf [80]; 

while (! read (infile, buf, 80)) 
write (outfile, buf, 80); 

} 
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reg_str 

Function 

Get register value 

Synopsis 

unsigned long reg_str (strl ) 
char *strl; 

Description 

The reg_str macro gets the contents of a register using a string variable 
representation of its name. This is not possible using standard debugger commands. 
The register value is returned by the macro. 

Diagnostics 

If the string does not contain a valid register name, an unknown value will be 
retumed and the debugger will display an error message in the debugger error 
window. 

Examples 

To display the value of register DO: 

Symbol Add char reg_name [ 1 0 ] 

Debugger Macro Call strcpy (reg_name, " @D0 " ) 

Expression Display_Value reg_str (reg_name) 

or. 

Expression Display_Value reg_str ( " @D0 " ) 
or. 

Expression C_Expression reg_str ("@D0") 
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showversioti 

Function 

Show the software version number for the debugger product 
Synopsis 

void showversion () 
Description 

The showversion macro hsts the software version number for your debugger 
product. 
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strcat 

Function 

Concatenate two strings 
Synopsis 

char *strcat (dest, src) 
char *dest, *src; 

Description 

The strcat macro appends a string to the end of another string. The string in src is 
appended to the string in dest and a pointer to dest is returned. 

Diagnostics 

No checking is done on the size of dest. 
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strchr 

Function 

Locate first occurrence of a character in a string 
Synopsis 

char *strchr (strl, byte_value) 
char *strl; 
char byte_value; 

Description 

The strchr macro returns a pointer to the first occurrence of the character 
byte_value in the string strl, if byte_value occurs in strl. 

Diagnostics 

If the character byte_value is not found, strchr returns a NULL pointer. For 
debugger variables, -1 (OxFFFFFFFF) is returned if byte_value does not occur. 
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strcmp 

Function 

Compare two strings 

Synopsis 

unsigned long strcmp (strl, str2) 
char *strl, 
char *str2; 

Description 

The strcmp macro compares strings in lexicographic order. Lexicographic order 
means that characters are compared based on their internal machine representation. 
For example, because an ASCII 'A' is 41 hexadecimal and an ASCII 'B' is 42 
hexadecimal, 'A' is less than 'B'. 

The strings strl and strl are compared and a result is returned according to the 
following relations: 

relation result 

si < s2 negative integer 

si = s2 zero 

si > s2 positive integer 

Diagnostics 

Strings are assumed to be NULL terminated or to be within the array boundaries. 
The comparison is always signed, regardless of how the string is declared. 
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strcpy 

Function 

Copy a string 

Synopsis 

char *strcpy (dest, src) 
char *dest, 
char *src; 

Description 

The strcpy macro copies src to dest until the NULL character is moved. (Copying 
from the right parameter to the left resembles an assignment statement.) A pointer 
to dest is returned. 

Diagnostics 

No checking is done on the size of dest. 
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stricmp 

Function 

Comparison of two strings witliout case distinction 

Synopsis 

unsigned long stricmp (strl, str2,) 
char *strl; 
char *str2; 

Description 

The stricmp macro compares strl with strl without case distinction. This means 
that the strings "ABC" and "abc" are considered to be identical. 

The strings strl and str2 are compared and a result is returned according to the 
following relations: 

relation result 

si < s2 negative integer 

si = s2 zero 

si > s2 positive integer 

Diagnostics 

Strings are assumed to be NULL terminated or to be within the array boundaries 
because the comparison is limited to the number of stated characters. The 
comparison is always signed, regardless of how the string is declared. 
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strlen 

Function 

String lengtli 

Synopsis 

unsigned long strlen (strl) 
char *strl; 

Description 

The strlen macro returns the length of a string. It returns the length of strl, 
excluding the NULL character. 

Diagnostics 

If strl is not properly terminated by a NULL character, the length returned is 
invaUd. 
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strncmp 

Function 

Limited comparison of two strings 

Synopsis 

unsigned long strncmp (strl, str2, count) 
char *strl; 
char *str2; 
unsigned count; 

Description 

The strncmp macro compares strings in lexicographic order. Lexicographic order 
means that characters are compared based on their internal machine representation. 
For example, because an ASCII 'A' is 41 hexadecimal and an ASCII 'B' is 42 
hexadecimal, 'A' is less than 'B'. 

The count in the synopsis above specifies the maximum number of characters to be 
compared. 

The strings strl and str2 are compared and a result returned according to the 
following relations: 



Diagnostics 

Strings are not required to be NULL terminated or to fit within the array boundaries 
because the comparison is limited to the number of stated characters. Less than 
count characters will be compared if the strings are smaller than count characters. 
The comparison is always signed, regardless of how the string is declared. 



relation 



result 



si <s2 
si =s2 
si >s2 



negative integer 
zero 

positive integer 
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until 

Function 

Run until expression is true 

Synopsis 

char until (boolean) 
int boolean; 

Description 

The until macro returns a zero when boolean is nonzero. The Until macro is used 
with the Program Run and Program Step With_Macro commands. It halts 
execution when the expression passed is true, and continues when the expression 
passed is false. Any C expression resulting in a value may be used. 

Example 

Program Run Until #3 ,#17 ,printf ; until (i==3 | | x < y) 

The command above sets temporary breakpoints at line numbers 3 and 17 in the 
current module and at entry to the function printf. When any one of these locations 
is encountered by the executing program, the debugger will stop and check the 
until conditional statements. If the variable ; is equal to 3, or the variable x is less 
than y, a break will occur. Otherwise, program execution continues. 
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when 

Function 

Break when expression is true 
Synopsis 

char when (boolean) 
int boolean; 

Description 

The when macro returns a zero when boolean is nonzero; it returns a one when 
boolean is zero. This macro is used with the Breakpt Instr command. When used 
with this command, program execution will halt when the stated expression is true, 
and will continue when the stated expression is false. Any C expression resulting in 
a value may be used. 

Example 

Breakpt Instr strcpy; when ( *str==0 ) 

This command sets a breakpoint at the entry point of the routine strcpy. Each time 
the breakpoint occurs, the when macro is executed. The macro causes program 
execution to stop when the byte pointed to by sir is zero. 
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word 

Function 

Return a word value at the specified address 
Synopsis 

unsigned short int word (addr) 
void *addr; 

Description 

The word macro returns a WORD (2-byte) value of the memory at the specified 
address. The value of the expression addr is computed and used as the address. 

Diagnostics 

The WORD value of the memory at that address is returned. 
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write 

Function 

Write to a system file 
Synopsis 

int write (fildes, buf, nbyte) 
int fildes; 
char *buf; 
unsigned nbyte; 

Description 

The write macro writes to a system file. This macro is an interface to the UNIX 
system call write(2). Refer to the HP-UX Reference Manual for detailed 
information. 

Diagnostics 

If the system call to write(2) is successful, the number of bytes written is retumed. 
Otherwise, -1 is returned and a system generated error message is written to the 
journal window of the debugger. 

Example 

The following command file segment defines two global debugger symbols and 
includes the definition of a user-defined macro that uses write(). 

Symbol Add int infile 
Symbol Add int outfile 

Debugger Macro Add int foo {infile, outfile) 

int infile; /* file descriptor to read from */ 

int outfile; /* file descriptor to write to */ 

{ 

char buf [80]; 

while (! read (infile, buf, 80)) 
write (outfile, buf, 80); 

} 
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15 




Debugger Error Messages 

A list of the error messages generated by the debugger. 
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The debugger displays the error window whenever it detects a command error. 
The debugger displays an error message and a pointer to the location where it 
detected the error. 



This chapter lists and describes the error messages and warnings issued by the 
debugger. These errors are listed numerically with possible error solutions. 
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Invalid characters follow command. 

A command was entered with incorrect characters or with more characters than 
were expected. Check the command name and re-enter the command. 

This command is not implemented yet. 

The command specified is currently not supported, but wiU be implemented in a 
later release. 

Unknown switch. 

An attempt was made to specify a switch that does not exist. Check the command 
syntax for the switches supported. 

Argument missing. 

A command was entered without an argument that is required to execute the 
command. Check the syntax description for the command and enter the command 
again with the correct argument specification. 

Invalid argument. 

The argument specified is not valid for this command. Check command syntax and 
re-enter the command with a valid argument. 

Unexpected separator encountered. 

The argument separator is not valid in this context. Check the syntax and enter the 
correct separator. 



1 0 Unknown expression character. 



The specified expression character is not recognized by the debugger. Check the 
syntax and enter the correct expression character. 



1 1 Missing ')',']% or '}' in expression. 



The matching right parentheses, right bracket, or right curly brace in the specified 
expression is missing. Check the expression and add the appropriate right delimiter. 
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1 2 Missing '(','[', or '{' in expression. 

The matching left parentheses, left bracket, or left curly brace in the specified 
expression is missing. Check the expression and add the appropriate left delimiter. 



1 3 Missing end quote. 



The second quotation mark for a character string is missing at the end of the line. 
Terminate the character string with an ending quotation mark. 



1 4 Invalid expression element. 

An expression element was specified incorrectly. The error window will display 
the expression specified and place a pointer at the position where the invalid 
element is located. Check the syntax description and re-enter the command. 
Possible errors include: invahd value, missing operand, missing operator, and 
unknown operand combination. 



1 5 Invalid filename. 

The filename specified could not be created. Valid filenames are dependent upon 
your host computer system. 



1 6 Invalid line number. 

The Une number specified is not vaUd. Line numbers must be preceded with a 
pound sign (#), and must be in a valid range. This error will occur if you enter a 
pound sign followed by zero or if you enter a pound sign without a number. 



1 7 Invalid address value. 

This error indicates that a value was used for an address that cannot be interpreted 
as an address (for instance, a floating point number). 



1 8 Invalid structure member. 

A member name was given that is not a member of the specified structure. Member 
names must be members of the specified structure. 



1 9 Invalid instruction address. 



This error occurs mainly in high-level mode. In high-level mode, this error will 
occur if the instruction address is not a function name or line number. Code 
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addresses in high-level mode may not be numeric or expressions. In assembly-level 
mode, most instruction address values are legal. 

20 Invalid port value. 

The specified port does not exist, or the port value was not specified with the 
Memory Inport Assign command. Port values must be specified with the Memory 
Inport Assign command. 

21 The values are not correct for this expression. 

An attempt was made to use an operand type that is not allowed for this operator. 
Operators must match operands according to the C language specifications. 

22 Upper bound less than lower bound. 

An attempt was made to specify a lower bound that is greater than the upper bound. 
The upper bound must be greater than the lower bound. 

23 Upper bound missing. 

An attempt was made to specify a lower bound without an upper bound. The upper 
bound must be specified. 

24 Function symbol ranges not allowed. 

An attempt was made to specify a range from one function to another in high-level 
mode. Function to line number is allowed. 

25 Range not of addresses. 

A print or trace command was entered, but the specified range contained a value 
instead of an address. Place an ampersand (&) before the symbol name in the range. 

26 Invalid screen specification. 

The command entered contains a screen specification that does not correspond to 
the screen where the specified window is located, or the specified screen does not 
exist. The screen number should be verified. 
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27 Invalid window specification. 

You tried to create or alter the size of a window, but the screen number, window 
number, or size coordinates were illegal. See the Window Open command for valid 
window specifications. 

28 Invalid cast. Must use format '(type)'. 

This error indicates that type casting was attempted outside of an expression, or 
without being enclosed in parentheses. Types can only be used in expressions as 
casts, and must be enclosed in parentheses. 

29 Unknown special key. 

A key was pressed that the debugger does not recognize. 

30 Start line invalid. 

The starting line for the Program Find_Source command may be omitted, or may 
be any valid line optionally within a module. 

31 Invalid exception vector. 

You tried to specify an exception vector that is invalid. In a Program Interrupt Add 
command, the optional exception vector must be in the range of 0 to 255. 

32 Invalid trace speed. 

An attempt was made to specify a step speed with the debugger Option General 
Step_Speed command that is not in the vahd range. Tracing speed ranges from 0 to 
100. 

33 Must be ON or OFF. 

An attempt was made to specify an invalid argument with an option. Options can 
be switched to ON or OFF. 

34 Cannot divide by zero. 

An attempt was made to divide by zero within an expression of Expression 
Display_Value or Expression C_Expression. 
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35 This feature not available in this version. 



51 This command cannot be used in this mode. 



A command that is not supported in the current mode was issued. The Program 
Display_Source command is only supported in high-level mode, and the Memory 
Display Mnemonic command is only supported in assembly-level mode. 



52 Switches cannot be used together. 



Two switches of the same group were given. Only one switch per group may be 
specified. 



53 Invalid switch given for this command. 



The specified qualifier is not associated with the specified command. Check the 
command syntax and re-enter the command. 

54 Value too large. 

A value that is out of range was specified. Values must be in the vaUd range for the 
command. 

55 Instruction expressions are invalid in this mode. 

An expression was used for a code address in high-level mode. Only a single line 
number or function symbol may be used in high-level mode. 

56 Module not found. 

The specified module name does not exist. Specify a valid module name. 

57 Line number not found. 

The hne number specified does not exist in the current module. If the line number 
exists in a different module, the module name must be specified. 

58 Symbol not found. 

The symbol name was entered incorrectly, or the symbol does not exist. The 
symbol name may have been mistyped. 
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59 Macro not found. 

The specified macro has not been defined, or an invalid macro name was entered. 
Check the macro name, or define the macro and re-enter the macro name. 



60 File not found. 

The specified file does not exist in the current directory, or in the search directories. 
Check the current directory for the filename that was specified. A typing error may 
have occurred. 



61 Structure member not found. 

The specified structure member does not exist in the specified structure. Check the 
structure definition for the member that was specified. A typing error may have 
occurred. 

62 Numeric addresses not allowed in this mode. 

An attempt was made to specify an invalid address value. 

63 Line numbers from different modules. 

Line numbers from different modules were specified. Only one module 
specification may be given. 

65 Port input does not come from file or string. 

You caimot rewind an input port that does not get its input from a file or a string. 



66 Port output does not go to a file. 



Only port output directed to a file may be rewound with the Memory Port Rewind 
Output command. 



67 This breakpoint is already set. 



An attempt was made to set a breakpoint that already exists. The current breakpoint 
must be deleted before it can be reset. 
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68 Port value not found. 

A port was specified that has not been created with the Memory Inport Assign or 
Memory Outport Assign command. 

69 Address in range already specified as Read_Only or Guarded. 

An address that was previously specified with a Memory Map Read_Only or 
Memory Map Guarded command was specified. Memory Map Read_Only and 
Memory Map Guarded commands can only act on Write_Read areas. 

70 Arguments do not match any Read_Only or Guarded area. 

The arguments specified with a Memory Map Write_Read command do not match 
the corresponding Memory Map Read_Only or Memory Map Guarded command. 
The arguments must match exactly. Entering a Memory Map Show command gives 
a map of Read_Only and Guarded areas. 

71 Address range contains unacceptable breakpoints. 

An iUegal breakpoint was specified. 

72 Bad size specification for window. 

An illegal size specification was given for a window. See the Window New 
command for the correct size specifications. 

73 Cannot repeat a cycle count of zero. 

A Program Interrupt Add command qualifier cannot request that an interrupt occur 
every zero cycles; this would cause an infinite loop. 

74 Invalid level number. Must be 1 to 7. 

The Program Interrupt Add command, as well as the 68300 family of 
microprocessors, permit 7 levels of interrupts. 

75 Attempt to delete nonexistent breakpoint(s). 

You tried to clear a breakpoint that was not previously set. Check that the 
breakpoint was set, or not already cleared. 
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76 Symbol not available from this scope unreferenced. 

You must reference the symbol with a qualified function or module name. 

77 Symbol with this name already exists. 

You tried to define a symbol that was previously defined. Another name should be 
used. 

78 Cannot create this symbol. 

An error occurred when trying to create the symbol. Check that it is vaUd as a 
symbol name. 

79 Symbol is not a module. 

An attempt was made to enter a symbol when a module was expected. 

80 Invalid stack level. 

This error indicates that a stack level was specified that is greater than the current 
stack nesting. 

81 Not a source function. 

An attempt was made to enter an illegal function with the Program Context Set 
command. The Program Context Set command requires either a module name or a 
source procedure name. 

82 Cannot delete this symbol. 

Registers and predefined symbols cannot be deleted. 

83 Invalid processor name. 

This error indicates that you specified a processor other than one supported by your 
debugger. See your user's guide for a list of supported microprocessors. 

84 Breakpoint limit exceeded. 

The number of breakpoints allowed has been exceeded. This breakpoint has not 
been set. 
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91 Internal command/expression processor error. 

An internal memory error has occurred. 

92 Not enough memory for expression. 

The expression specified requires more memory than there is available. Try 
clearing breakpoints or deleting macros to obtain more memory. 

93 Invalid memory/register address. 

An attempt was made to read or write to inaccessible target memory. Target 
memory that is protected cannot be read from or written to. 

94 Source is not available for this module. 

An attempt was made to access source code in an assembly language module. Use 
the Debugger Level command or the F3 function key to switch to assembly-level 
mode to display this module. 

95 Cannot build source table. 

There is not sufficient memory available to buUd the source table for source display. 

96 Cannot read absolute file. 

An attempt was made to load a file that is not an absolute object module. The code 
may need to be compiled, assembled, or linked. 

97 Cannot build disassembly table. 

There is not sufficient memory available to build the disassembly table for 
up-arrow and page-up support in the disassembler. 

98 Cannot split monitor lines. 

An attempt was made to monitor different elements on the same Une. Only one 
element per line may be monitored. 

99 No empty lines available. 

An attempt was made to specify a line number with the Expression Monitor Value 
command, but the entire window is already filled. The number of lines in the data 
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window is limited to 17. Use the Expression Monitor Delete command to delete 
some of the Unes. 

1 00 No available windows. 

This error indicates that the numbers allocated for user-defined windows have all 
been used. Some windows must be deleted before creating another user-defined 
window. 

101 Cannot open file. 

An attempt was made to open a file that does not exist. 

1 02 Local variable not alive. 

A local variable was specified, but the function containing the variable is not active 
(current or nested). 

1 03 No source level information available. 

The source file for the specified source module cannot be found. 

1 04 A log or journal file is already open. 

An attempt was made to open a new log file when one is already in use. Close the 
existing log file with the File Log Off command before opening a new log file. 

1 05 Not a color monitor. 

1 06 Not enough memory. 

This error indicates that not enough memory was available for the specified 
command. 

1 07 Terminated when processing absolute file. 

This error indicates that an invalid control value was encountered in loading the 
".x" file. 
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1 08 At start of function, no local variables yet 

This error indicates that arguments and local variables are not available to the 
debugger at this time. They are available when the prolog to the function has been 
executed. 

1 09 Local already defined. 

This error indicates that a local variable has been defined twice in a macro 
definition. One definition of the variable must be deleted. 

110 This argument not defined. 

This error indicates that an argument was declared that was not defined on the 
command line with the Debugger Macro Add command. 

111 This macro is in use already. 

Macros cannot be called recursively. 

112 This is not allowed outside of a macro. 

Keywords are allowed in macros only. 

113 Cannot begin execution from a macro. 

Program Run, Program Step With_Macro, Program Step, and Program Step Over 
are not allowed from within macros. The PC may be altered with the Memory 
Register @PC= command. 

114 This command not allowed from a macro. 

Some commands are not allowed from a macro, such as Debugger Host_Shell and 
Debugger Macro Add. 

115 InvaUd float expression, results in NAN. 

A floating point expression resulted in a non-number. 

116 Cannot convert float value. 

Float value is too large to convert to an integer. 
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117 Help file unavailable. 

This error indicates that the help tile, "db68k.hlp", was not found. 

118 Unsupported float type. 

A floating point type other than 32 or 64 bit has been defined. 

119 Cannot get address of register or constant 

An attempt was made to find the address of a register or constant. One example is: 
Expression Display_Value &@al. 

121 Cannot open command file for reading. 

This error indicates that the command file specified cannot be found. 

1 22 Include file name too long. 

This error indicates that the filename specified (including its pathname) is too long 
to be handled by the debugger's internal buffers. Limit the number of characters in 
the filename specification, or move the file to the default directory. 

1 23 Could not read source line. 

This error indicates that there was an error reading the C source file. 

1 24 Cannot create file for logging. 

This error indicates that there was an error when trying to create the specified log 
file or that the current directory does not have write permission. 

1 25 Write error occurred while writing to a file. 

This error indicates that the disk is probably full. 

1 26 Cannot open startup file <startupfile>. 

This error indicates that the debugger could not open the specified setup fUe. The 
filename may have been misspelled, or the filename does not exist. 
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1 27 Invalid number of arguments for macro. 



This error indicates that an incorrect number of arguments was specified in the call 
or too many parameters were used in the macro definition. 

1 28 Cannot show built-in macros. 

This error indicates that predefined macros cannot be shown with the Debugger 
Macro Display command. They have no text. 

1 29 Runtime error in macro. 

This error indicates that an error occurred when executing a macro. 

1 30 Command not implemented in simulator version. 

This error indicates that the command entered will not work in this version of the 
debugger. 

131 "option chip" not implemented in this version. 

This error indicates that "option chip" will not work in this version of the debugger. 

1 32 Breakpoint adjusted. 

This error indicates that the breakpoint has been moved to an address at the start of 
an instruction. See the Debugger Option General Align_Bp command syntax 
description in the "Debugger Commands" chapter. 

1 33 Error return from child process. 

This error indicates that an error was returned when interacting with the host 
system through the Debugger Host_Shell command. 

1 34 This command cannot be executed from batch mode. 

This error indicates that the command entered will not work in batch mode. 

1 35 No search string available. 

The command Program Find_Source Next was entered without previously entering 
the Program Find_Source Occurrence command. 
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1 36 Cannot open file for logging; file in use for commands. 

The file specified for logging is currently open and being used to read commands 
from. Choose another name for the log file. 



1 37 Cannot open file for logging; file in use for logging. 

The file specified to read commands from is open and being used as a log file. Tum 
off logging with the File Log OFF command or choose another name for the 
command file. 



141 Miscellaneous error. 

This is a message from the emulator which was not processed by the debugger. AU 
available error information is displayed on the screen. Any one of a number of 
error messages may be displayed on your screen. 

One possible error message is: 

No valid BBA spec file for <processor> processor 

You must have the HP Branch Validator product for your processor installed on 
your system in order to use the Memory Unload_BBA command. 

Another possible message is: 

BREAK active, cannot set up TRACE TRIGGER 

You must delete all breakpoints before you can set up a trace. Select 
Breakpoints^Delete All then try setting the trace again. 



1 42 Miscellaneous warning. 

This is a message from the emulator which was not processed by the debugger. AU 
available warning information is displayed on the screen. Any one of a number of 
warning messages may be displayed on your screen. 



1 43 Miscellaneous note. 

This is a message from the emulator which was not processed by the debugger. AU 
available information is displayed on the screen. Any one of a number of notice 
messages may be displayed on your screen. 
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1 44 Miscellaneous fatal error. 

All available fatal error information is displayed on the screen. The debugger will 
then quit. 

1 45 Too many interrupts pending. 

Too many Program Interrupt commands have been given without a sufficient 
number of interrupts being processed. The current Umit on pending interrupts is 16. 

1 46 Voids liave no value. 

This error message is retumed when certain commands are attempted on voids. 

1 47 Invalid suboption. 

This suboption does not work with this command. Refer to the "Debugger 
Commands" chapter of this manual for valid suboptions for various commands. 

1 48 Invalid option. 

This option does not work with this command. Refer to the "Debugger Commands" 
chapter of this manual for vahd options for various commands. 

1 49 No temporary breakpoints for the macro. 

The command Program Run From <addr>;<macro> will return this error because a 
temporary breakpoint has not been specified. 

1 50 Invalid type for this argument, expecting a target address. 

The command was expecting an address. Re-enter the command with a target 
memory address. 

151 Invalid type for this argument, expecting a number. 

The command was expecting a number. Re-enter the command with a number. 

1 52 Cannot delete: more than one symbol with this name. 

Multiple symbols with the same name exist. More fully quahfy the symbol to make 
it unique and then retry the command. 
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1 53 Cannot save into this address (not 'lvalue'). 

The expression used is not an address. This command can only save at an address 
which is an 'lvalue' . Check the address and then retry the command. 

1 54 Invalid type for macro argument. 

This is an invalid type for the macro argument. Refer to the chapter on macros for 
more information on vahd types for macro arguments. 

1 55 Stopped by user. 

The execution of this command was halted by the user. 

1 56 Not a logical expression (==, !=, <, >, <=, >=, !). 

The expression entered is not a logical expression. Refer to the "Expressions and 
Symbols in Debugger Commands" chapter for more information on logical 
expressions and then re-enter the command. 

1 57 Cannot create log file. 

Unable to open the specified file as a journal file. 

1 59 Interrupted during I/O. 

Keyboard I/O was in cooked mode and a read from the keyboard was interrupted. 

161 Bad command for current context (No root, start, etc.) 

1 62 Ambiguous member name, must qualify witli more local class. 

The referenced C++ member function may be one of several function which have 
the same name. Use a class name to be more specific. 

1 63 Cannot currently access via virtual base class. 

164 Too many parameters in a #define constant. 
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16 



Debugger Versions 

Information about how this version of the debugger differs from previous versions. 
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Version C.05.31 

Support for the HP 64782 emulator 

The debugger now supports the HP 64782 6833x emulator. The debugger still 
supports the HP 64749 6833x emulator. 

Support for MRI ROM monitor 

The debugger supports the MRI ROM monitor, as described in the accompanying 
note. 

Support for the HP Software Probe 

The debugger now supports the HP Software Probe, which may be used in place of 
an emulator. 

New symbol matching options 

Options have been added to allow you to control the case-sensitivity for debugger 
symbols. 



Version C.05.20 

Journal browser added for GUI versions 

Joumal window output may now be sent to a graphical browser window if desired. 
See the Windows Journal Browser pulldown and File Journal Browser 
command line help for more iirformation. 

Demand loading is now default 

Demand loading now defaults ON for products that support it. These are currently 
the products using HP/MRI IEEE-695 file format executables. Startup files will 
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override the default, and the -d and -doff command line options will override both 
the startup and the default. 

New commands added on command line 

The following are new commands: 

• Breakpoint Erase 

• Program Load Reload 

• Program Load Options_Set 

See the command line help for details on these commands. Note that the 
Breakpoints^Delete () pulldown now uses the Breakpt Erase command rather 
than the VBreakpt Delete command, so that the cut buffer should contain the 
address of the breakpoint rather than the number of the breakpoint when deleting. 
This allows deleting break- points in the same fashion as they are set. 

HP64_DEBUG_PATH search path changed 

The debugger will now search for source files in the location specified by the 
absolute file, and then the current directory, if not found in any of the directories 
specified in the optional HP64_DEBUG_PATH environment variable. The 
debugger previously did not search these directories when the 
HP64_DEBUG_PATH variable was set, unless specifically defined by the path. 

Support for #define constants added 

The debugger now allows the use of #define constants in expressions. The compiler 
you use must place this information into the absolute file. 

New Predefined Macro 

A new debugger macro, getsym, has been added. It has one parameter, an address, 
and returns a char pointer to a string that is the first symbol at that address. A null 
string is returned if no symbol exists at the given address. 
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Version C.05.10 

Easier Emulator Configuration 

The configuration dialog for the 68332 emulator has been completely revised. The 
new dialog graphically displays the emulator configuration, and allows you to 
make changes using the mouse. Further information about the emulator 
configuration has been made available through the new Debugger Execution 
Environment Cfg_Info command. 

Larger Symbol Table 

The debugger can load up to 16 million symbols. The previous limit was 64K 
symbols. 

Each symbol uses 128 bytes of memory. If so many symbols are loaded that your 
host operating system runs out of swap space, the practical limit may be less than 
16 million symbols. 

More Global Symbols 

The maximum number of global symbols that can be read from an HP-MRI 
IEEE-695 file has been increased from 8000 to 64K symbols. 

Radix Option Side Effects 

Input and output values are interpreted as hexadecimal only for assembly-level 
references. 

To cast a high-level expression as hexadecimal, use a leading "Ox" or a trailing "h". 

When the radix option is set to hex, the following inputs will not be interpreted as 
hexadecimal: 

• line numbers starting with "#" 

• variables in high-level expressions, including C_Expression and macro 
expressions. 

• debugger variables including: 
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- breakpoint numbers 

- viewport numbers 

- data viewport line numbers 

New Demand Loading Option 

The -doff command line option turns off demand loading, overriding the option in 
the startup fUe. 

Better Support for SIM Module Registers 

Previous versions of the debugger restricted memory address ranges. The values of 
the SIM registers after resetting the processor can now be set in the emulator 
configuration. The new Debugger Execution Environment SyncSlM command 
allows you to copy and compare SIM register values. The Debugger Execution 
Environment Unrestricted command is no longer needed, and has been removed 
from the debugger. 

New Registers 

Several EMxxx registers have been added. The "Registers" chapter gives a 
complete Ust of register names. 



Version C.05.01 
Graphical User Interface 

The debugger now has a graphical user interface. Some of the many features of the 
graphical interface include: 

• puU-down and pop-up menus 

• user-definable action keys 

• a mouse-driven command line 

• improved on-line help 

• powerful macro editing 
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• interactive emulator configuration 

The debugger's old standard interface may still be used. 

New Product Number 

The old product number of this debugger was HP 64365 for HP 9000 Series 300 
computers. The new number is HP B1473B. 

New Reserved Symbols 

@ENTRY is the address of the first executable statement in a function. For 
example, funcl\@ENTRY is the first executable statement of fund. If you set a 
breakpoint at funcl\@ENTRY rather than at fund, the local variables mfuncl wUl 
be active. 

@ROOT is the name of the root of the symbol tree represented by the program 
counter. 

@FILE is the name of the file containing the current program counter (if any). 

New Predefined Macro 

The cmd_forward() macro allows you to send commands to other interfaces (such 
as the emulator interface) which are coimected to the emulator. You can even use 
this macro to let your target code control the debugger. 

Environment Variable Expansion 

Operating system environment variables wUl now be expanded when they appear 
in a debugger command. 

For example, "Debugger Directory Change_working $HOME/test" will now work 
as expected. 

Target Program Function Calls 

You may now reference target program functions in C expressions. 

Target and debugger variables may be passed by value, and target variables may be 
passed by reference. 
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C++ Support 

The debugger now supports C++ name mangling/de-mangling and object/instance 
breakpoints for the Microtec Research Inc. C++ compiler. 

Simulated Interrupts Removed 

The debugger/emulator no longer supports simulated interrupts. 



Simulated I/O Changes 

The debugger's simulated I/O features are now compatible with the emulation 

interface's simulated I/O. 

Simulated I/O in the debugger/emulator now requires the setting up of simulated 
I/O poHing and addresses in the emulator configuration. 

The 1/0 Report no longer reports on processes used. 

The keyboard EOF function is no longer supported since it is not supported by the 
emulation interface's I/O. 
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How to install the debugger software on your computer. 
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Installation at a Glance 

The debugger/emulator is a tool for debugging C programs for 68300 series 
microprocessors in a emulation execution enviroimient. 

Follow these steps to install the debugger/emulator: 

1 Install the software on your computer. 

2 Install the emulator hardware. 

3 Set up your software enviroimient to run the debugger. 

4 Verify the software installation. 

Supplied interfaces 

When an X Window System that supports OSF/Motif interfaces is running on the 
host computer, the debugger/emulator has a graphical interface that provides 
pull-down and pop- up menus, point and chck setting of breakpoints, cut and paste, 
on-line help, customizable action keys and pop-up recall buffers, etc. 

The debugger/emulator also has a standard interface for several types of terminals, 
terminal emulators, and bitmapped displays. When using the standard interface, 
commands are entered from the keyboard. 

The installation procedure described in this chapter shows you how to install both 
debugger/emulator interfaces and verify the installation. 
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Supplied filesets 

As you install the software, you will see a list of the filesets on the tape. The 
filesets are identified by their HP product number. 

The tape may contain several products. Usually, you will want to install all of the 
products on the tape. 

However, to save disk space, or for other reasons, you can choose to install selected 
filesets. 

Emulator/Analyzer Compatibility 

If you are using both the debugger's graphical interface and the emulator/analyzer 
interface, check that you have an up-to-date version of the emulator/analyzer 
software. Your emulator/analyzer software should have the same revision number 

as the debugger software: 5.xx. 

If the emulator/analyzer software has a revision number of 4.xx or earher, the 
following restrictions apply: 

• Do not run the debugger at the same time as the emulator/analyzer window. 
However, you may use them nonconcurrently. 

• Use the debugger interface, not the emulator/analyzer interface, to load and 
modify the emulation configuration. Thus, be sure to start your session from 
the debugger. 

C Compiler Installation 

Some older versions of HP C Cross Compilers will overwrite the file 
$HP64000/bin/db68k, making the graphical interface unavailable. If you encounter 
this problem, install the C compiler before you install the debugger software. 
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To install software on an HP 9000 system 



Required l-lardware and Software 

To install and use the debugger/emulator's graphical interface, you need: 

• HP 9000 Series 300/400 computer running HP-UX version 8.01 or later, or 
HP 9000 Series 700 computer running HP-UX version 8.01 or later. 

To check the HP-UX operating system version, enter the uname -a command 
at the HP-UX prompt. If the version number of the HP-UX operating system 
is less than 7.03, you must update the operating system to version 7.03 or 
higher before you can use the debugger. (Refer to the "Updating HP-UX" 
chapter of the HP-UX System Administration Tasks manual for detailed 
information concerning updating your system. 

Moti£/OSF. For HP 9000 Series 700 workstations, you must also have the 
Motif 1 .1 dynamic link libraries installed. They are installed by default, so 
you do not have to install them specifically for this product, but you should 
consult your HP-UX documentation for confirmation and more information. 

Hardware and Memory. The debugger/emulator's graphical interface 
requires workstations to have a minimum of 16 megabytes of memory. Series 
300 workstations should have a minimum performance equivalent to that of a 
HP 9000/350. A color display is also highly recommended. 

• Approximately 16 Mbytes of disk space. 

• HP B 1473 debugger/emulator software. 
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Step 1 . Install the software 

During the install process, you have some choices about how much you load from 
the product media. As a general rule, you should load everything from the media. 

The following sub-steps assume that you want to install all products on the tape. 

1 Become the root user on the system you want to update. 

2 Make sure the tape's write-protect screw points to SAFE. 

3 Put the product media into the tape drive that will be the source device for the 
update process. 

4 Confirm that the tape drive BUSY and PROTECT lights are on. 

If the PROTECT light is not on, remove the tape and make sure the tape' s 
write-protect screw points to SAFE. If the BUSY light is not on, check that the 
tape is installed correctly in the drive and that the drive is operating correctly. 

5 When the BUSY Ught goes off and stays off, start the update program by entering 

/ etc/ update 

6 When the HP-UX update utility main screen appears, confirm that the source and 
destination devices are correct for your system. Refer to your HP-UX System 
Administration documentation if you need to modify these values. 

7 Select "Load Everything from Source Media" when your source and destination 
directories are correct. 

8 To begin the update, press the softkey <Select Item>. At the next menu, press the 
softkey <Select Item> again. Answer the last prompt with y. It takes about 20 
minutes to read the tape. 

9 When the installation is complete, read /tmp/update.log to see the results of the 
update. 
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To install the software on a Sun SPARCsystem™ 
Required l-lardware and Software 

To install and use the debugger/emulator's graphical interface, you need: 

• Sun SPARCsystem computer running Solaris version 2.3 or SunOS version 4.1 
or 4. 1. 1 or greater. The tape uses the QIC-24 data format. 

To check the SunOS operating system version, enter the uname -a command 
at the UNIX prompt. If the version number of the SunOS operating system is 
less than 4.1, you must update the operating system to version 4.1 or higher 
before you can use the debugger. For instructions on updating your system, 
see the Sun Installing SunOS manual. 

• System V software. To find out whether the System V environment is already 
installed on your system, check that the directory /usr/5bin exists. For 
instructions on installing System V, see the Sun Installing SunOS manual. 

• System V IPC facilities (semaphores). To find out whether the IPC faciUties 
are installed on your system, type ipcs. For instructions on installing the IPC 
facilities, see the Sun System and Network Administration manual. 

• At least 16 megabytes of memory (for the graphical user interface). 

• Color display (optional, but recommended for the graphical user interface). 

• Approximately 3 Mbytes of disk space. 

• HP B 1473 debugger/emulator software. 
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Step 1 : Install the software 

For instructions on how to install software on your SPARCsystem, refer to the HP 
64000-UXfor SPARCsystems — Software Installation Guide. 

Normally you should install all of the filesets on the tape. 



Step 2: Map your function keys 

If you are using the character-based Standard Interface, map your function keys by 
following the steps below: 

1 Copy the function key definitions by typing: 

cp $HP64000/etc/ttyswrc -/.ttyswrc 

This creates key mappings in the .ttyswrc file in your $HOME directory. 

2 Remove or comment out the following line from your .xinitrc file: 
xmodmap -e 'keysym Fl = Help' 

If any of the other keys F1-F8 are remapped using xmodmap, comment out those 
lines also. 

3 Add the following to your .profile or .login file: 

stty erase 
setenv KEYMAP sun 

The erase character needs to be set to backspace so that the Delete key can be used 
for "delete character." 

If you want to continue using the Fl key for HELP, you can use use F2-F9 for the 
Softkey Interface. All you have to do is set the KEYMAP variable. If you use 
Open Windows, type: 
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setenv KEYMAP sun. 2-9 

If you use xterm windows (the xterm window program is located in the directory 
/usr/openwin/demo), type: 

setenv KEYMAP xterm. 2-9 

Reminder: If you are using OpenWindows, add /usr/openwin/bin to the end of the 
$PATH definition, and add the following line to your .profile: 

setenv OPENWINHOME /usr/openwin 
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To install the emulator hardware 



1 If necessary, install the emulator hardware into the HP 64700 Card Cage. 

Turn to the HP 64700 Series Installation/Service Guide and follow the instructions 
for installing emulator, memory, or analyzer cards in the HP 64700 Series 
Cardcage. It may be that you already have installed the cards in the cardcage or 
your cardcage came with cards already installed. 

2 Configure the HP 64700 for the communication channel. 

Turn to the HP 64700 Series Installation/Service Guide and follow the instructions 
for configuring the emulator to communicate via LAN, RS-422, or RS-232. 
(RS-422 and RS-232 are only supported on HP 9000 Series 300/400 machines.) 

3 Connect the HP64700 to your host computer. 

Turn to the HP 64700 Series Installation/Service Guide and follow the instructions 
for connecting the emulator to your system. You can connect the emulator via 
LAN, RS-422, or RS-232. 

When you have installed the emulator hardware, continue with Step 3 of these 
instructions. 



See Also If you are using an HP Software Probe instead of an emulator, read the 

HP Software Probe User's Guide for installation instructions. 
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To set up your software environment 

Follow these steps to prepare your computer to run the debugger: 

1 Start the X server. 

2 Set the necessary environment variables. 



To start the X server 

If you are not already running the X server and a window manager, do so now. The 
X server is required to use the Graphical User Interface because it is an X Windows 
application. A window manager is not required to execute the interface, but, as a 
practical matter, you must use some sort of window manager with the X server. 

• If you are using an HP workstation, start the X server and the Motif window 
manager by entering: 

xllstart 

• If you are using a Sun workstation, enter: 

/ usr/ openwin/bin/ openwin 

Consult the X Window documentation supplied with the operating system 
documentation if you do not know about using X Windows and the X server. The 
chapter "Using X Resources" in this book also discusses X Windows and the X 
server. 
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To start HP VUE 

If you will be using the X server under HP VUE and have not started HP VUE, do 
so now. 

HP VUE differs slightly from other window managers in that it does not read your 
.Xdefaults file to find resources you may want to customize. Instead, it uses 
resources from the X resource database. In order to customize resources for the 
Graphical User Interface under HP VUE therefore, you must either merge a file of 
customized resources with the X resource database, or set an environment variable 
that causes the X resource manager to read a file of customized resources. For ease 
of use, choose the .Xdefaults file as your merge file. 

• To merge the file .Xdefaults with the X resource database, enter 

xrdb -merge .Xdefaults 
at the HP-UX prompt. 

Customized resources will be merged with the X resource database and will be 
available for retrieval by the Graphical User Interface. 

• To enable the graphical interface to find the .Xdefaults file directly, enter the 
following commands: 

XENVIRONMENT=$HOME/ .Xdefaults 
export XENVIRONMENT 

The graphical interface wiU be able to find and read the file in order to retrieve 
customized resources. 
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To set environment variables 

The following instructions show you how to set these variables at the UNIX 
prompt. Modify your ".profile", ".login", or ".vueprofile" file if you wish these 
environment variables to be set when you log in. 

• Set the DISPLAY environment variable. 

• Set the HP64000 environment variable. 

• Set the PATH environment variable to include the usr/hp64000/bin directory. 

• Set the MANPATH enviroimient variable. 

For the ksh login shell (most HP systems), set a variable by entering 

export <variable>=<value> 

For the csh login shell (most Sun systems), set a variable by entering 

setenv <variable> <value> 

The DISPLAY enviroimient variable must be set before the debugger's graphical 
interface will start. Consult the X Window documentation supplied with the UNIX 
system documentation for an explanation of the DISPLAY environment variable. 

Set the HP64000 environment variable to usr/hp64000 under the path where you 
installed the software. If you installed the software relative to a directory other than 
the root directory, it is strongly recommended that you use a symbolic link to make 
the software appear to be under /usr/hp64000. 

Modify the PATH environment variable to include the $HP64000/bin directory and 
the HP64_DEBUG_PATH environment variable to specify search paths. 

Modify the MANPATH environment variable to include the $HP64000/man 
directory. This directory contains the on-line "man" page information. 

See Also For iirformation on setting the location of C source files, see page 8 1 . 



630 



Chapter 17: Installation 
To set up your software environment 

Examples These examples use ksh syntax. If you are using csh as your login shell, then use 

the setenv style instead. 

If your system is named "myhost," set the display variable by typing: 

export DISPLAY=mYhost : 0 . 0 

If you installed the HP 64000 software in the root directory, "/", enter: 
export HP64000=/usr/hp64000 

export PATH=$PATH: $HP64000/bin 

export MANPATH=$MANPATH: $HP64000/man 

If you installed the software in the directory /users/team, enter: 

export HP64000=/users/team/usr/hp64000 
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To find the logical name of your emulator 

The logical name of an emulator is a label associated with a set of communication 
parameters in the $HP64000/etc/64700tab.net file. The 64700tab.net file is placed 
in the directory as part of the installation process. 

1 Display the 64700tab.net file by entering 

more $HP64700/etc/64700tab.net at the HP-UX prompt. 

2 Page through the file until you find the emulator you are going to use. 



This step will require some matching of information to an emulator, but it should 
not be difficult to determine which emulator you want to address. 

If you find the emulator listed in the file, note its name. If the emulator is not listed, 
you must modify the file (see the next page) in order for the debugger to access the 
emulator. 



Examples A typical entry for a 68332 emulator cormected to the LAN would appear as 

follows: 

# 

# Channel I Logical I Processor | Remainder of Information for the Channel 

# Type I Name I Type I (IP address for LAN connections) 
# 

Ian: emul68k * 21.17.9.143 

A typical entry for an emulator coimected to an RS-422 port would appear as 
follows: 

# 

# 

# Channel I Logical 

# Type I Name 

# I 
# 

serial: emul68k * myhost /dev/emcom23 OFF NONE RTS 2 8 



I I Xpar I Parity I Flow | Stop | Char 

Processor | Host 1 Physical IModel 1 I Bits I Size 

Type I Name I Device I I I XON | | 

I I I OFF I NONE I RTS 12 18 
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To add an emulator to the 64700tab.net file 

1 Make up a logical name for the emulator. 

You will use this name to identify the emulator whenever you start the debugger. 
The name emul68k is used as an example throughout this manual. 



2 If the emulator is connected to a LAN, find out the Internet Address (IP address) of 
the emulator. (You will also need the LAN address to Ust the emulator in the 
/etc/hosts file.) 



If the emulator is connected using a serial port, find out the name of the computer 
to which the emulator is connected, the device file name for the emulator, the baud 
rate of the serial channel, and the flow control protocol of the serial channel. 



3 Edit the $HP64000/etc/64700tab.net file and add a hne for the emulator. The new 
line should look like one of the examples given on the previous page. 

See Also The HP 64700A Card Cage Installation/Service Guide. 

The 64700tab on-line manual page. 



To add an emulator to the /etc/hosts file 



• If the emulator is connected via a LAN, edit the /etc/hosts file to add a hne 
consisting of the emulator's Internet Address (IP Address) and name. 
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To verify the software installation 

A number of new filesets were installed on your system during the software 
installation process. This step assumes that you chose to load the iilesets for the 
debugger/emulator's graphical interface. 

You can use this step to further verify that the filesets necessary to successfully 
start the graphical interface have been loaded and that customize scripts have run 
correctly. Of course, the update process gives you mechanisms for verifying 
installation, but these checks can help to double-check the install process. 

1 Verify the existence of the HP64_Debug file in the $HP64000/Xll/app-defaults 

subdirectory by entering 

Is $HP64000/Xll/app-defaults/HP64_Debug 

Finding this file verifies that you loaded the correct fUeset and also verifies that the 
customize scripts executed because this file is created from other files during the 
customize process. 

2 Examine $HP64000/Xll/app-defaults/HP64_Debug near the end of the file to 
confirm that there are resources specific to your microprocessor. 

Near the end of the file, there will be resource strings that contain references to 
specific microprocessors. For example, if you installed the debugger/emulator's 
graphical interface for the 68300 series microprocessors, resource name strings will 
have "debug*m68332" embedded in them. 
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absolute file An executable module generated by compiling, assembling, and 
linking a program. Absolute files must have an extension of .x. 

action key User-definable buttons in the graphical interface which allow quick 
access to often-used commands. 

application default file A file containing default X resource specifications for 
an X Window System application. 

background monitor An emulation monitor program that does not execute as 
part of the user program. See "emulation monitor". 

BBA The Hewlett-Packard Branch Validator. It is a software tool you can use to 
analyze your testing, create more complete test suites, and measure your level of 
testing. 

breakpoint A location in the program at which execution should stop. 

cascade menu A secondary menu that appears when you select an item from a 
puU-down menu. 

click To press and immediately release a mouse button. The term comes from the 
fact that pressing and releasing the buttons of most mice makes a cUcking sound. 

command file An ASCn file containing debugger commands. 

command line An area at the bottom of the debugger window where commands 
may be entered using softkeys or pushbuttons. All standard interface commands 
are entered using the command line. 

command token The smallest part into which a command may be 
broken — usually one word. Command tokens appear as pushbuttons on the 
command line. 
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concurrent usage model Describes an interi'ace in which the user can peri'orm 
most comands at the same time that code is being executed under emulation. 

configuration file See "emulator configuration file". 

cooked keyboard I/O mode The I/O mode in which keyboard input is 
processed. This lets you type and then edit the line to correct errors. 

cut buffer A synonym for "entry buffer". 

dialog box Sometimes called a secondary window, the dialog box is called by 
the user from the application's main window. A dialog box contains controls or 
settings, and sometimes prompts for text entry. 

display area The part of the debugger window which shows windows containing 
information such as high-level code and breakpoints. 

double-click To press the mouse button twice, quickly. 
E/A The Emulator/Analyzer window. 

emul700dmn The UNIX background process which coordinates the actions and 
message traffic of the major emulation interfaces. 

emulation memory Memory provided by the emulator to be used in place of 
target system memory. 

emulation monitor A program that is executed by the emulation processor that 
allows the emulation controller to access target system resources. For example, 
when you display target system memory locations, the monitor program executes 
the microprocessor instructions that read the target memory locations and send 
their contents to the emulation controller. See also "foreground monitor" and 
"background monitor". 

emulator An instrument that performs just like the microprocessor it replaces, 
but at the same time, it gives you information about the operation of the processor. 
An emulator gives you control over target system execution and allows you to view 
or modify the contents of processor registers, target system memory, and I/O 
resources. 
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emulator configuration file A file that contains configuration settings and 
memory map definitions for the emulator. 

entry area A section of the command line area where commands are built. 
When you use menus or softkeys, the actual command which the debugger will 
execute appears in the entry area. 

entry buffer The part of the graphical interface which contains "input" for 
commands. The symbol for the entry buffer is "()". 

execution engine Hardware or software used to execute program code. 
Examples include an emulator, a target system with a ROM monitor, a target 
system with an HP Software Probe, or a simulator. 

foreground monitor An emulation monitor program that executes as part of the 
user program. See "emulation monitor". 

grapllical interface The debugger interface program that uses graphics-oriented 
software such as windows, menus, and icons to make interaction easy. 

ilOSt siiell A UNIX command interpreter, 
iconify The act of turning a window into an icon. 

journal file A file that contains commands entered during a debug session and 
any ouQ)ut generated by the debugger. Journal files contain everything that is 
written to the debugger's journal window. 

log file A command file that is created by the debugger when you record 
commands. 

macro A C-like function consisting of debugger commands and C statements and 

expressions. Macros are most often used to patch C source code, create conditional 
breakpoints, retum values to expressions, or execute a set of commands. 

menu bar The row of words at the top of the graphical interface window. 
Clicking on the menu bar will display a menu of debugger commands. 

monitor See "emulation monitor". 
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patch A small, temporary change to executable code. 

PITS cycle Programming In The Small cycle. The repeating process of editing, 
compiling, and executing code to eUminate bugs. 

pointer The symbol on your computer's screen which shows where the mouse is 
pointing. The pointer may be a hand, an arrow, or another shape. 

pop-up menu A menu that pops up when you press and hold the right mouse 
button. Pop-up menus are available whenever the mouse pointer changes to a 
"hand-cursor". 

predefined macro See also "macro". 

pull-down menu A menu that appears to "pull down" from the menu bar at the 
top of the interface window. 

pushbutton A graphic control that simulates a real-life pushbutton. Use the 
pointer and mouse to push the button and immediately start an action. 

raw keyboard I/O mode The I/O mode in which each keystroke produces a 
character that is sent to the target program that is reading from the keyboard. 

recall buffer A text entry field which remembers its previous value, 
resource See "X resource". 

scheme file A file that contains X resource specifications for a particular group 
of resources, for example, for a particular type of display, computing environments, 
or language. 

scroll bar A scroll bar is used to move a window so that you can see information 
beyond the window's edge. 

sequential usage model Describes a user interface in which user code 
execution must be stopped before the interface can perform most commands. 



shell See "host shell", 
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simulated I/O The debugger feature that lets user programs read input from, and 
write output to, the same keyboard and display (respectively) that are used to 
control the debugger. Simulated I/O also lets user programs use the UNIX file 
system and run UNIX commands. 

simulated program interrupt User program interrupts that are simulated by 
the debugger. Simulated interrupts can be one-time interrupts or periodic interrupts. 

simulator A software tool that simulates a microprocessor system for the purpose 
of debugging user programs. 

Software Probe The HP Software Probe is a low-cost alternative to an emulator. 
It uses the processor's Background Debug Mode to control execution and to access 
registers and memory. Because it does not include an analyzer, the HP Software 
Probe does not support read/write breakpoints or trace analysis. 

SPA The HP Software Performance Analyzer. 

standard interface The traditional debugger interface designed for use with 
several types of terminals, terminal emulators, and bitmapped displays. When 
using the standard interface, commands are entered from the keyboard. 

startup file A file that contains information regarding debugger options and 
screen configurations. 

state file A file that contains the CPU state (including register values) and a 
memory image. This file is saved within a debugger session and can be loaded at a 
later time to return to a particular state of execution. 

Status line A line which displays debugger information such as the CPU type, 
the current module name, and the current debugger operation. 

sticky slider A scrollbar shder which is designed for local navigation in a large 
file. Moving the slider moves the contents of the active window just a few pages at 
a time. 

storage qualifier A bus cycle state description that causes only particular states 
to be stored in the analyzer trace. 
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trace A collection of states captured on the emulation bus (in terms of the 
emulation bus analyzer) or on the analyzer trace signals (in terms of the external 
analyzer) and stored in trace memory. 

trace event A bus state consisting of a combination of address, data, and status 
values. 

trigger The captured analyzer state about which other captured states are stored. 
The trigger state specifies when the trace measurement is taken. 

window A window inside the debugger's display area. See also "X window". 

working directory The current directory from which the debugger loads and 
saves files. 

X resource A piece of data that controls an element of appearance or behavior in 
an X appUcation. 

X server A program that controls all access to input devices (typically a mouse 
and a keyboard) and all output devices (typically a display screen). It is an 
interface between application programs you run on your system and the system 
input and output devices. 

X window A window on your computer' s display. The debugger' s graphical 
interface runs inside an X window. See also "window". 
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0 entry buffer, 637 

/dev/simio/display reserved symbol, 160 
/dev/simio/keyboard reserved symbol, 160 
6400tab.net fUe, 632-633 

absolute file, 635 

absolute files, 82-83 

access breakpoints, using with trace, 171 

access size (target memory), 296 

action keys, 7, 635 

custom, 254 

operation, 52 

with command files, 254 

with entry buffer, 51-52 
activating windows, 15 
active window 

changing, 127 

description of, 127 

displaying the alternate view of, 128 

viewing information in, 129-131 
add symbol, 116 
adding an emulator, 632-633 
address operator, 30 

address overlays, memory mapping, 290, 318 
addresses, 533-534 

assembly level code, 533 

code, 533 

data, 533 

displaying variable, 30 
ranges, 533 

trace specification, 487 
alignment 

tracing instructions, 392 
alternate view of a window, 128 
ambiguous address error message, 290, 318 
analysis breakpoints, 92 



app-defaults directory 

HP 9000 computers, 336 

Sun SPARCsystem computers, 336 
append programs, 85 
application default file, 635 
application resource 

See X resource 
arguments for macros, 205 
Asleep (debugger status), 70 
assembly code 

in source display, 234 
assembly level code addresses, 533 
assembly-level screen 

description of, 121 

displaying, 122 

moving status window, 241 
AwtRst (debugger status), 70 

background, 275 

tracing, 298 
background monitor, 276, 635 

selecting, 275-282 
backtrace window 

backtrace information, 141 

description of, 140-142 

display bad stack frames, 231 

frame status characters, 141 

function name, 141 

function nesting level, 140 

halting at stack level, 102 

module name, 141 
batch mode option, 226 
BBA 

See Branch Validator 
bindings, mouse, 9-11 
block size, emulation memory, 284 
blocks 

comparing, 198 

copying, 197 

filling, 198 
Branch Vahdator, 114, 635 
break on access to a variable, 31 



break_info macro, 554-555 
breakpoint window 

address field, 100 

command argument, 101 

description of, 99 

line niunber field, 100 

module/function field, 100 

number field (#), 100 

type field, 100 
breakpoints 

analysis, 92 

automatic alignment, 231 
C++, 96-97 

checking definitions of, 99 
clearing, 97 

commands, summary of, 346 

controlling program execution with, 92-102 

definition, 635 

deleting, 24, 97 

hardware, 92 

removing, 97-98 

setting, 21 

software, 95 

use macros with, 214 
Breakpt Access command, 352-353 
Breakpt Clear_All command, 354 
Breakpt Delete command, 355 
Breakpt Erase command, 356 
Breakpt Instr command, 357-358 
Breakpt Read command, 359 
Breakpt Write command, 360 
breaks on write to ROM, 297 
bus width, 392 

BusGmt (debugger status), 70 
button names, 9-11 
byte macro, 556 
bytes 

changing, 196 

C compiler 

installation, 621 
C operators, 523 



C source code 
displaying, 133 

C-H- 

breakpoints, 96-97, 357 
browse command, 151, 468 
classes, 468, 536 
displaying class members, 148 
displaying member values, 148 
functions, 96-97, 133 
inheritance, 468 
object instance, 96 
objects, 148 
operators, 524 

overloaded functions, 96, 357 

protection, 148 

this pointer, 144 
calling a macro, 203 
cascade menu, 635 
case-sensitivity, 389 
casting, special, 542 
changes to the debugger, 72 
changing 

active window, 127 

directory context in configuration window, 264, 308 
characterization of memory, 286 
characters 

constants, 528 

non-printable, 528 

string constants, 528 
check breakpoint definitions, 99 
check simulated I/O resource usage, 164 
chip select registers (SIM), 368 
chip selects 

mapping memory, 320 
chip selects, access emulation memory with, 285, 317 
class name 

X applications, 335 

X resource, 333 
class name for X resources, 249 
classes (C++) 

displaying members of, 148 



clear breakpoints, 97-98 

click, 635 

client, X, 246,332 

clock source selection, emulator configuration, 271 

close macro, 557 

CMBWait (debugger status), 70 

cmd_forward macro, 558-559 

code addresses, 533 

code patching 

deleting C source lines from your program, 194-195 

inserting lines of C code into your program, 194 

patching a line, 193 
color scheme, 248, 252, 338 
column numbers, 532 
Compile (debugger status), 69 
Command (debugger status), 69 
command files 

command-line option, 221, 226 

comments in, 219 

definition, 635 

description of, 218-226 

echoing commands, 230 

logging commands to, start, 219 

logging commands to, stop, 220 

playback, 221 

startup, 421 
command language 

address ranges, 533 

addresses, 533-534 

assembly level code addresses, 533 

C operators, 523 

C++ operators, 524 

character constants, 528 

character string constants, 528 

code addresses, 533 

constants, 526 

data addresses, 533 

data types, 539 

debugger operators, 525 

debugger symbols, 531 

description, 521-550 



command language (continued) 
evaluating symbols, 547 
explicit stack references, 549 
expression elements, 523-529 
expression strings, 537 
floating point constants, 527 
forming expressions, 536 
global (extern) storage classes, 538 
hexadecimal constants, 526 
identical module names, 544 
identifiers, 530 
implicit stack references, 548 
integer constants, 526 
keywords, 535 

legal characters allowed in symbols, 530 

line numbers, 532 

local storage classes, 539 

macro local symbols, 531 

macro names, 531 

macro symbol types, 531 

macro symbols, 531 

module names, 545 

non-printable characters, 528 

operators, 523 

program symbols, 530 

referencing symbols, 543 

register storage classes, 539 

reserved symbols, 532 

root names, 543 

scoping rules, 543 

special casting, 542 

stack references, 548 

static storage classes, 538 

storage classes, 538 

symbol length, 530 

symbolic referencing, 538-550 

symbohc referencing with exphcit roots, 545 

symbohc referencing without exphcit roots, +, 547 
symbols, 530-532 
type casting, 541 
type conversion, 541 



command line, 7, 635 

command line recall operation, 66 
Command Recall dialog box, operation, 62 
copy-and-paste to from entry buffer, 51 
displaying, 32 

editing entry area with keyboard, 66 
editing entry area with pop-up menu, 62 
editing entry area with pushbuttons, 61 
entering commands, 60 
entry area, 637 
executing commands, 60 
help, 63 
mapping, 63 

recalling commands with command line recall, 66 

recalling commands with dialog box, 62 

turning on or off, 59, 249 

with keyboard, 64-68 
Command Recall dialog box operation, 53 
command select button, 9-10 
command tokens, description, 635 
command tokens, description of, 64 
commands 

editing in command line entry area, 61-62, 66 

entering, 39, 41-74 

entering from keyboard, 64 

entering in command line, 60 

executing in command line, 60 

function key, 41 

logging to command file, start, 219 
logging to command file, stop, 220 
map, 291, 319 

playback from command file, 221 

recalling with command line recall, 66 

recalling with dialog box, 62 
comments in macros, 204 
communication between interfaces, 558 
compare blocks of memory, 198 
comparison of foreground/background monitors, 276 
compile programs for the debugger, 76-80 
compiler 

configuration file, 267 



compiler h option, effects of, 76 
concurrent usage model, 636 
configuration, 300 

help for configuration items in dialog boxes, 309 
configuration (emulator) 

background states, tracing, 298 

breaks on writes to ROM, 297 

monitor entry after, 271 

monitor selection, 275-282 

program counter, 295 

restrict to real-time runs, 272 

supervisor stack pointer, 295 
configuration context 

displaying from configuration window, 308 
configuration file, 636 

creating, 268 

if an error occurs while loading, 268 

loading, 266 

modifying, 268 
configuration, debugger, 227-256 
configuration, emulator, 257-258, 260-298 

displaying current directory, 264 

exiting the interface, 265, 310 

loading from file, 310 

modifying a section, 261, 303 

sections, 263 

starting the interface, 260, 301 

storing, 262, 307 
constants, 526 

character, 528 

character string, 528 

floating point, 527 

hexadecimal, 526 

integer, 526 
context 

changing directory in configuration window, 264, 308 

displaying directory from configuration window, 264, 308 
control blocking of reads, 162 
control character functions 

list of, 42 

using, 42 



control program execution with breakpoints, 92-102 

controlling trace depth, 393 

cooked mode, 636 

copy block of memory, 197 

copy macros, 208 

copy window, 131 

copy-and-paste 

addresses, 49 

from entry buffer, 51 

multi- window, 49, 52 

symbol width, 49 

to entry buffer, 48 
CPU in wait state, status message, 280, 286 
create a configuration file, 268 
current working directory, displaying, 138 
cursor keys 

descriptions, 129 

End (Shift_Home) Key Functions, 130 
Home Key Functions, 130 
cut buffer 

See entry buffer 

data addresses, 533 

data strobe qualified chip selects, 317 

data types, 539 

db68k options 

-b batch mode, 226 

-c command file, 221, 226 

-d demand loading of symbols, 85 

-I load only symbolic information, 84 

-j journal file, 223 

-1 log commands, 219 

-s startup_file, 245 
debugger commands, summary of, 346 
Debugger Directory command, 361 
Debugger Execution Display_Status command, 362 
Debugger Execution Environment Cfgjnfo command, 363-364 
Debugger Execution Environment FwdCmd command, 365 
Debugger Execution Enviroimient Load_Config command, 366 
Debugger Execution Environment Modify_Config command, 367 
Debugger Execution Environment SyncSIM command, 368 
Debugger Execution IO_System command, 369-371 



Debugger Execution Load_State command, 372 
Debugger Execution Reset_Processor command, 373 
Debugger Help command, 376 
Debugger Host_Shell command, 374-375 
Debugger Level command, 377 
Debugger Macro Add command, 378-380 
Debugger Macro Call command, 381 
Debugger Macro Display command, 382 
debugger macros 

See macros 
debugger operators 

See operators 
Debugger Option Breakpts command, 384 
Debugger Option Command_Echo command, 383 
Debugger Option General command, 385-387 
Debugger Option List command, 388 
Debugger Option Symbolics command, 389-391 
Debugger Option Trace command, 392-393 
Debugger Option View command, 394-396 
debugger options dialog box, 229 
Debugger Pause command, 397 
Debugger Quit command, 398-399 
debugger symbols 

See symbols 
debugger version, 72 
decimal, 232 

Deep Emulation Analyzer, 393 
default ttace specification, 169 
define macros, 208-209 

interactively, 208 

See macros 
define user screens and windows, 241 
delete breakpoints, 98 

delete C source lines from your program, 194-195 
delete macros, 217 
delete symbol, 118-121 
delete ttace events, 177 
deleting breakpoints 

See breakpoints, deleting 
demand loading symbols, 85 
demonstration program description, 11 
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dialog boxes 

Command Recall, operation, 53, 62 
debugger options, 229 
definition, 636 

Directory Selection, operation, 53, 56 

Entry Buffer Recall, operation, 50, 53 

File Selection, operation, 53, 55 

how to use, 53 

macro operations, 207 
directories 

displaying current directory, 138 

changing in configuration window, 264 

displaying from configuration window, 264 
directory context 

changing in configuration window, 308 

displaying from configuration window, 308 
Directory Selection dialog box operation, 53, 56 
disable simulated I/O, 160 
disassembly 

automatic alignment, 231 
disassembly of instructions, incorrect, 92 
display area, 7, 636 

lines, 250 
display area windows 

See windows 
displaying 

See the name of what you want to display in this index 
do statement, 206 
double-click, 636 
DTACK interlock, 286 
dual-port emulation memory, 272 
dword macro, 560 

E E/A, 636 

editing 

command line entry area with keyboard, 66 
command line entry area with pop-up menu, 62 
command line entry area with pushbuttons, 61 
copying memory, 197 
file, 249 

file at address, 191, 249 
file at program counter, 191 
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editing (continued) 

files, 190-191 

macros, 210 

memory contents, 196 
8-bit memory, substituting emulation memory for, 285, 317 
else statement, 206 
emul700dmn, 636 
emulation configuration 

help for items in dialog boxes, 309 
emulation memory, 284, 636 

8-bit, substituting for, 285, 317 

block size, 284 

dual-port, 272 

size of, 284 

synchronizing to target system, 286 
emulation monitor, 636 

function of, 275 
emulator, 113, 636 

adding, 632 

configuration, 257-258, 260-298 
configuration introduction, 258 
configuring, 266 
installing, 627 

restrict to real-time runs, 272 
version requirement, 621 
emulator configuration 

break processor on write to ROM, 297 
clock selection, 271 
examining, 263 

exiting the configuration interface, 310 

exiting the Emulator Configuration dialog box, 265 

loading from file, 310 

modifying a configuration section, 261, 303 

monitor entry after, 271 

starting the configuration interface, 301 

starting the Emulator Configuration dialog box, 260 

storing, 262, 307 

target memory access size, 296 

trace background/foreground operation, 298 
emulator Umitations, external DMA support, 285 
emulator/analyzer interface, 113 



enable simulated I/O, 160 

End (Shift_Home) Key Functions, 130 

end debugging session, 36 

engine, execution, 637 

entering debugger commands, 39, 41-74 

from the keyboard, 64 
entries (X resource), 255 
entry area (command Une), 637 
entry buffer, 7, 637 

address copy-and-paste to, 49 

clearing, 48 

copy-and-paste from, 51 
copy-and-paste to, 48 
editing, 51 

Entry Buffer Value Selection dialog box, operation, 50 

multi-window copy-and-paste from, 52 

multi-window copy-and-paste to, 49 

operation, 51 

recalling entries, 50 

setting initial value, 255 

symbol width and copy-and-paste to, 49 

text entry, 48 

with action keys, 51-52 

with pull-down menus, 51 
Entry Buffer Recall dialog box operation, 53 
environment dependent files, 76 
environment variables 

HP64_DEBUG_PATH, 81 

MANPATH, 630 
cram, memory characterization, 286 
erase information in window, 242 
erasing 

flash memory, 108-110 
erom, memory characterization, 286 
error macro, 561 

error window, description of, 592 
evaluating symbols, 547 

Execute (debugger status), 69 

executing UNIX commands from within the debugger, 112 



execution 

controlling, 87-91 

run from current program counter address, 89 

run from start address, 89 

run until stop address, 90 
execution engine, 637 
exiting the debugger, 36 
explicit stack references, 549 
Expression C_Expression command, 400 
Expression Display_Value command, 401-403 
Expression Fprintf command, 404-408 
Expression Monitor Clear_all command, 409 
Expression Monitor Delete command, 410 
Expression Monitor Value command, 411-413 
Expression Printf command, 414 
expressions 

changing C variables 

commands, summary of, 347 

elements, 523-529 

forming, 536 

strings, 537 

fast termination mode, 285, 317 

fgetc macro, 562 

file 

emulator configuration, 307 

emulator configuration load, 310 
File Command command, 415 
File Error_Command command, 416 
file extensions 

.EA and .EB, configuration files, 263 

.EA configuration files, 307 
File Journal command, 417-418 
File Log command, 419-420 
File Selection dialog box operation, 53, 55 
File Startup command, 421^22 
File User_Fopen command, 423-424 
File Window_Close command, 425 



files 

6400tab.net, 632-633 
absolute, 82-83 
appending, 85 
command, 218-226 
See also command file 
commands, summary of, 347 
See also configuration file 
editing, 190-191 
editing at address, 191 
editing at program counter, 191 
emulator configuration, 262 
enviroimient dependent, 76 
journal, 223 
log, 219 

logging commands to, start, 219 
logging commands to, stop, 220 
macro, 210 

playback command file, 221 

saving window contents, 131 

source file location, 81 

startup, 244-245, 421^22 

state, 106-107 
fill block of memory, 198 
flash memory, 108-110 

programming using command line, 439 
floating point constants, 527 
fopen macro, 563 
foreground, 275 
foreground monitor, 276, 637 

advantages/disadvantages, 276 

customizing, 276 

example of using, 282 

limitations to trace, 172 

memory space required, 276 

selecting, 275-282 

single-step processor, 278, 280-281 

source file location, 276 
foreground operation, tracing, 298 
fork a UNIX shell. 111 
forming expressions, 536 
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G 



H 



frame status character, 141 
function codes 

mapping memory, 290, 318 

memory mapping, 290, 318 

need for separately linked modules, 290, 318 
function keys, 41 

list of, 41 
functions 

breaking on call, 21 

displaying, 18 

stepping over, 27, 88 

getsym macro, 564 
graphical interface 

C compiler installation, 621 
guarded memory accesses, 286, 290, 319 

half -bright video, 237 

Halted (debugger status), 70 

halting program execution 

on access to a specified memory location, 92 
on instruction at a specified memory location, 94 

hand pointer, 47 

hardware 

breakpoints, 92 

HP 9000 memory needs, 622 

HP 9000 minimum performance, 622 

HP 9000 system requirements, 622 

locking emulator, 398 

SPARCsystem memory needs, 624 

SPARCsystem minimum performance, 624 

SPARCsystem minimums overview, 624 

help 

command line, 63 

help index, 57 

to use, 35 

window, 67 
help for configuration items, 309 
hexadecimal 

changing default radix, 232 

constants, 526 

effects of radix, 232, 387, 614 
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high-level screen 

description of, 120 

displaying, 122 

moving status window, 240 
highlighting, setting, 237 
Home Key Functions, 130 
Host_Shell command, 111 
hot keys 

See action keys 
HP 9000 

700 series Motif libraries, 622 

HP-UX minimum version, 622 

system requirements, 622 
HP-UX 

minimum version, 622 
HP64_DEBUG_PATH file search path, 81 

iconify, 637 

identifier, 530 

if statement, 206 

implicit stack references, 548 

incorrect disassembly of instructions, 92 

increase simulated I/O file resources, 164-166 

indicator characters, 71 

initialized variables 

re-initiahzing, 199 
InMon (debugger status), 70 
input scheme, 248, 338 
insert lines of C code into your program, 194 
installation 

at a glance, 620-621 

emulator, 627 

SPARCsystem specific instructions, 624-626 
instance name 

X applications, 335 

X resource, 333 
instruction alignment, 392 
integer constants, 526 
interface, emulator configuration 

exiting, 265, 310 

modifying a section, 261, 303 

starting, 260, 301 
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interfaces 

emulator/analyzer, 113 
interlock DTACK, 286 
interrupts, 276 
inverse video, 237 
isalive macro, 565 

J J indicator character, 71 
journal files, 223 
definition, 637 
for journal window, 152 
-j option, 223 

name of current journal fUe, 138 
journal window, 132, 417 
journal window, description of, 42 

K key_get macro, 566 
key_stat macro, 567 
keyboard 

choosing menu items, 46 

key names, 10-11 
keyboard I/O 

control blocking, 162 

cooked mode, 161 

raw mode, 161 

setting mode, 161 

simulated I/O processing, 161 
keywords, 535 

L L indicator character, 71 
label scheme, 248, 252, 338 
LANG environment variable, 338 
level, stack, 102 
libraries 

Motif for HP 9000/700, 622 
line numbers, 389, 532 
lines in main display area, 250 
literals 

radix, 232 
load additional programs, 85 
load programs, 82-83 

using the db68k command, 82 

using the program load command, 82 
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load symbols, 84 

loading and executing programs, 75, 77-114 
locking mechanism, emulation, 398 
log files, 219 

definition, 637 

for log file window, 152 

name of current log file, 138 
logging 

-1 option, 219 

commands to command file, start, 219 
commands to command file, stop, 220 

Macro (debugger status), 69 
macros, 201-226 

arguments, 205 

calling, 203 

calling from an expression, 212 

calling from within macros, 213 

calling on execution of a breakpoint, 214 

calhng with debugger macro call command, 211 

calUng with Program Step With_Macro command, 215 

comments, 204 

control flow statements, 206 

copying, 208 

debugger commands in, 206 

defining, 204, 207-209 

defining interactively, 207-208 

defining outside the debugger, 209 

definition, 637 

deleting, 217 

dialog box, 207 

displaying source code of, 217 

do statement, 206 

editing, 210 

else statement, 206 

example of 'when', 353, 358-360 

finding commands, 63 

if statement, 206 

limits, 204 

loading, 211 

local symbols, 531 

maximum number of Unes in a macro, 379 
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macros (continued( 
names, 531 

patching C source with, 193-195 

predefined, 551-590 

properties of, 203 

renaming, 208 

return statement, 206 

return values, 206 

saving, 204, 210 

simulated I/O, 552 

stopping execution, 216 

symbol types, 531 

symbols, 531 

templates, 208 

using with breakpoints, 214 

variables, 205 

while statement, 206 
main(), displaying, 16 
make windows active, 127 
making trace measurements, 167-188 
man pages, setting path to, 630 
map command, 291, 319 
mapping memory, 283-292 
mcc68k 

See Microtec 
memchr macro, 568 
memclr macro, 569 
memcpy macro, 570 
memory 

changing, 196 

characterization of, 286 

commands, summary of, 348 

comparing, 198 

copying, 197 

dual-port emulation, 272 

fiUing, 198 

flash, 108-110 

mapping, 283-292 

See also memory map 

re-assigimient of emulation memory blocks in mapper, 289 
Memory Assign command, 426-427 
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Memory Block_Operation Copy command, 428 
Memory Block_Operation Fill command, 429-430 
Memory Block_Operation Match command, 431-432 
Memory Block_Operation Search coimnand, 433-434 
Memory Block_Operation Test command, 435-436 
Memory Display command, 437-438 
Memory Flash coimnand, 439 
Memory Hex command, 440-441 
memory mapping 

block size, 283 

chip select specification, 320 

function code specification, 290, 318 

overlaid addresses, 290, 318 

resolution, 283 

using emulation memory in place of target, 291, 319 
memory recoimnendations 

HP 9000, 622 

SPARCsystem, 624 
Memory Register coimnand, 442-443 
Memory Unload_BBA command, 444-445 
memset macro, 571 
menu bar, 637 
menus, 44-57 

editing command line with pop-up, 62 

hand pointer means pop-up, 47 

mapping to commands, 63 

puU-down operation with keyboard, 46 

puU-down operation with mouse, 44-45 
Microtec 

compiler, 80 
middle button, 9 
modify a configuration file, 268 
modify registers, 199-200 
module names, 545 
module names, identical, 544 
monitor (emulation) 

address of, 278, 281 

comparison of foreground/background, 276 
foreground monitor filename, 281 
foreground or background, 275-282 
function of, 275 
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monitor (emulation, continued) 
selecting, 275-282 

selecting entry after configuration, 271 
moiutor window, description of, 149 
more display, 237 
More prompt, 131 
Motif 

HP 9000/700 requirements, 622 

mouse 

button names, 9 

choosing menu items, 44-45 
mouse button names, 10-11 
move assembly-level status window, 241 
move high-level status window, 240 
move status window, 240 
multi-statement debugging, 532 
multi-window 

copy-and-paste from entry buffer, 52 

copy-and-paste to entry buffer, 49 

N names of modules, identical, 544 
next screen, displaying, 123-126 
non-printable characters, 528 
notes 

re-assignment of emulation memory blocks by mapper, 289 
selecting internal clock forces reset, 271 
NotRdy (debugger status), 70 

O objects (C++) 

displaying member values, 148 
open macro, 572-573 
operating notice, 72 
operating system 

HP-UX miiumum version, 622 

SunOS miiumum version, 624 
operators 

C,523 

C++, 524 

debugger, 525 
optimizing modes 

effects of, 77 

using, 77 
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options, 228 

radix, 232, 387, 614 

saving, 421-422 
overlaid addresses 

memory mapping, 318 
overlapping addresses, memory mapping, 290 
overloaded C++ functions, 96, 133 

paging (screen), 237 
patch 

See also code patching 

definition, 638 
Paused (debugger status), 69 
PC 

See program counter 

PC register, 113 

PITS cycle, 638 

platform 

differences, 10-11 

HP 9000 memory needs, 622 

HP 9000 minimum performance, 622 

SPARCsystem memory needs, 624 

SPARCsystem minimum performance, 624 

platform scheme, 248, 340 

playback 

command file, 221 

pod_command macro, 574-575 

pointer, 638 

pop-up menus 

command line editing with, 62 
definition, 638 

hand pointer indicates presence, 47 
shortcuts, 48 
using, 47 
predefined macros, 551-590 
breakjnfo, 554-555 
byte, 556 
close, 557 

cmd_forward, 558-559 
dword, 560 
error, 561 
fgetc, 562 



predefined macros (continued) 

fopen, 563 

getsym, 564 

isalive, 565 

key_get, 566 

key_stat, 567 

memchr, 568 

memoir, 569 

memcpy, 570 

memset, 571 

open, 572-573 

pod_command, 574-575 

read, 576 

reg_str, 577 

showversion, 578 

strcat, 579 

strchr, 580 

strcmp, 581 

strcpy, 582 

stricmp, 583 

strlen, 584 

stmcmp, 585 

until, 586 

when, 587 

word, 588 

write, 589-590 
predefined windows, 125 
printf 

using in debugger, 32 
processor 

resetting, 103 
product version, displaying, 138 
program commands, summary of, 349 
Program Context Display command, 446 
Program Context Expand command, 447 
Program Context Set command, 448 
program counter 

reset values, 295 

resetting, 104 

run from current address, 89 



Program Display_Source command 

description, 449 
program execution 

controlling, 87-91 

halt on access to a specified memory location, 92 

halt on an instruction at a specified memory location, 94 
Program Find_Source Next command, 450 
Program Find_Source Occurrence command, 451-452 
Program Load command, 453-455 
Program Pc_Reset conmiand, 456 
Program Run command, 457-459 
Program Step command, 460-461 
Program Step Over conmiand, 462-463 
Program Step With_Macro command, 464 
program stepping, 26 
program symbols 

See symbols 
program variables, resetting, 104 
programming 

flash memory, 108-110 
programs 

loading, 82-83 

loading using the db68k command, 82 

loading using the program load command, 82 

restarting, 103-105 

run from a specified address, 89 

run from the current program counter address, 89 

run until a specified stop address, 90 

running, 87-91 

step through, 87 
puU-down menus 

choosing with keyboard, 46 

choosing with mouse, 44-45 

definition, 638 
pushbutton, 638 

quick start 

graphical interface, 3-36 
quitting the debugger, 36 



R indicator character, 71 
radix 

selecting, 232 
radix option, 232, 387, 614 
RAM, mapping emulation or target, 286 
raw mode, 638 
re-initialize variables, 199 
read macro, 576 
Reading (debugger status), 70 
real-time runs 

commands not allowed during, 272 

commands which will cause break, 272 

restricting emulator to, 272 

restricting the emulator to, 272 
recall buffer, 638 

initial content, 255 
recalling 

commands with command line recall, 66 

commands with dialog box, 62 

entry buffer entries, 50 
redirect I/O, 162-163 
referencing symbols, 543 
reformat screens, 239 
reg_str macro, 577 
register window, description of, 138 
registers 

changing, 199-200 

list of, 139 

modifying, 113 

monitoring, 150 

SIM, 363 

SIM chip select, 368 

viewing, 138 
release_system, end command option, 307 
remote control of intefaces, 558 
remove breakpoints, 97-98 
remove user-defined screens and windows, 243 
reserved symbols, 532 

/dev/simio/display, 160 

/dev/simio/keyboard, 160 

displaying, 139 



reserved symbols (continued) 

simulated 1/0, 159 

stderr, 160 

stdin, 159 

stdout, 160 
Reset (debugger status), 70 
reset processor, 103 
reset program counter, 104 
reset program variables, 104 
resize 

windows, 239 
resolution, memory mapper, 283 
resource 

See X resources 
restart programs, 103-105 
restrict to real time runs, 272 

target system dependency, 272 
retum statement, 206 
retum values in macros, 206 
revisions, debugger interface, 72 
ROM 

mapping emulation or target, 286 

writes to, 286 
root names, 543 
root symbol, 544 
run 

from current program counter address, 89 
from start address, 89 
programs, 87-91 
until stop address, 90 

save file 

See state files 
save window and screen settings, 244 
SC compiler 

compiler, 267 
scheme files, 247, 638 
scheme files (for X resources), 336, 338 

color scheme, 248, 252, 338 

custom, 252, 339 

input scheme, 248, 338 

label scheme, 248, 252, 338 



scheme files (continued) 

platform scheme, 248, 340 

size scheme, 248, 339 
scoping rules, 543 
screens, 120 

saving settings, 244 

assembly-level, 121 

displaying, 120 

displaying next, 123-126 

high-level, 120 

high-level, displaying, 122 

predefined, 120 

reformatting, 239 

standard 1/0, 121 

user-defined, displaying, 242 

working with, 120 
scroll bar, 7, 17, 638 
scrolling, 17 

"more" mode, 131 

setting amount of, 237 

sticky shder definition, 639 
selecting emulation monitor, 275-282 
sequential usage model, 638 
server, X, 246,332,640 
session control commands, summary of, 346 
setting 

keyboard I/O mode to raw or cooked, 161 
settings, 228 

See also options 

saving, 421-422 
shell, 637 

forking, 111 
showversion macro, 578 
SIM chip select registers, 368 
SIM module registers, 363 
simulated I/O, 258, 300, 639 

check resource usage, 164 

communication with the debugger, 158 

connections to host system, 158 

control address buffers, 158 

description of, 157 



simulated VO (continued) 

disabling, 160 

display, 158 

enabling, 160 

how it works, 158 

increase file resource, 164-166 

keyboard, 158 

keyboard 1/0, 161 

keyboard I/O processing, 161 

macros, 552 

processing, 158 

redirecting I/O, 162-163 

reserved symbols, 159 

special symbols, 159 

stderr, 162-163 

stdin, 162-163 

stdout, 162-163 

UNIX Files, 158 

UNIX processes, 159 

user program symbols, 159 

using, 157 
simulator, 639 
size scheme, 248, 339 
skid, 352 

skipping functions, 27 
slider, sticky, 639 

See also scrolling 
SlowBus (debugger status), 70 
SlowClk (debugger status), 70 
software 

installation for SPARCsystems, 624-626 
software breakpoints, 95 
software probe, 639 
source code 

displaying, 133 

in assembly display, 234 

location of fUes, 81 

patching, 192 
SPA, 639 



SPARCsystems 

installing software, 624—626 

minimum system requirements overview, 624 

SunOS minimum version, 624 
special casting, 542 
special symbols, simulated I/O, 159 
specify source file location, 81 
specify trace events, 176 
speed setting (step), 233 
stack 

displaying bad frames, 231 

explicit references, 549 

halting at stack level, 102 

implicit references, 548 

window, description of, 126 
stack pointer, defining supervisor, 295 
standard I/O screen 

description of, 121 

displaying, 123 

erasing information, 242 
standard interface 

definition, 639 

installation, 625 
start address, run from, 89 
starting 

debugger, 14, 43 

logging commands to command file, 219 

trace, 173 
startup files, 244-245 

definition, 639 

loading, 245 

name of, 138 

-s option, 245 
state files, 106-107, 639 
status 

entry on status line, 69 
moving status window, 240 
status line, 7, 69-72, 639 

viewing, 137 

status messages, CPU in wait state, 280, 286 
stderr reserved symbol, 160 



stdin reserved symbol, 159 
stdio 

See standard I/O 

See also stdin, stdout 
stdout reserved symbol, 160 
step over functions, 27, 88 
step speed, setting, 233 
step through a program, 87 
stepping, 26 
sticky slider, 639 

See also scrolling 
stop address, run from, 90 
stoping 

logging commands to command fUe, 220 

trace, 174 
stopping 

debugger, 36 
storage classes 

automatic, 539 

global (extern), 538 

local, 539 

register, 539 

static, 538 
storage qualification 

qualifier, delinition of, 639 

specifying qualifiers, 177 

trace measurement, 170 
strcat macro, 579 
strchr macro, 580 
strcmp macro, 581 
strcpy macro, 582 
stricmp macro, 583 
strlen macro, 584 
stmcmp macro, 585 
structures 

displaying members, 147 
subroutines 

See functions 
subwidows 

activating, 15 



SunOS 

minimum version, 624 
supervisor stack pointer, reset values, 295 
switching 

between high-level and assembly-level screens, 122 

directory context in configuration window, 264, 308 
Symbol Add command, 465-467 
Symbol Browse command, 468 
Symbol Display command, 469-473 
Symbol Remove command, 474-475 
symbolic information only option, 84 
symbolic referencing, 538-550 

with explicit roots, 545 

without explicit roots, 547 
symbols 

assembly code, 234 

commands, summary of, 349 

debugger, 116, 531 

demand loading, 85, 231 

displaying, 117 

evaluating, 547 

evaluation, examples of, 547 

keywords, 535 

legal characters, 530 

length, 530 

line numbers, 532 

loading, 84 

macro, 531 

on demand, 530 

program, 116, 530 

referencing, 543 

reserved, 139, 532 

types of, 116 
SyncSIM command, 368 
system requirements 

HP 9000 overview, 622 

HP-UX minimum version, 622 

OSF/Motif HP 9000/700 requirements, 622 

SPARCsystem overview, 624 

SunOS minimum version, 624 



target memory 

access size, 296 
target program 

control of emulator interfaces, 558 
target system 

dependency on executing code, 272 

RAM and ROM, 286 
TargPwr (debugger status), 71 
TargRst (debugger status), 70 
template 

macro, 208 
token, 635 
trace 

Deep Emulation Analyzer, 393 

depth control, 393 

See trace measurement 
trace depth 

controlling, 393 
Trace Display command, 477-482 
Trace Event Clear_All command, 483 
Trace Event Delete command, 484 
Trace Event List coirmiand, 485 
Trace Event Specify command, 486-489 
Trace Event Used_List command, 490 
trace events, 169 

address values, 169 

data values, 169 

definition, 640 

delete, 177 

specify, 176 

status values, 169 
Trace Halt command, 491 
trace measurement, 167-188, 640 

access breakpoints, 171 

address and data values, 169 

breakpoint interaction, 353 

bus width, 392 

commands, summary of, 350 

complex breakpoint, 185 

default, 169 

delete trace events, 177 
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trace measurement (continued) 
disable storage qualifiers, 180 
disable triggers, 181 
display a trace, 175 
fetch mask, 238 

foreground monitor limitations, 172 

halt program on occurrence of trigger, 180 

limitations, 172 

limitations when triggering on C variables, 172 
remove storage qualifiers, 180 
remove triggers, 181 
resources, 170 

specify storage qualifiers, 177 
specify trace events, 176 
start a trace, 173 
status, 71, 170 
status values, 169 
stop a trace, 174 
storage qualification, 170 
timing information, 238, 392 

trace code execution before and after entry into a function, 181 

trace counts, 238 

trace data written to variable, 182 

trace events, 169 

trace modules, 186-188 

trace trigger, 169 

trace write to a variable, 184 

trace writer of data, 183 

triggers, 178-179, 640 

what it does, 168 
Trace Start command, 476 
Trace StoreQual command, 492-495 
Trace StoreQual Event command, 496-497 
Trace StoreQual List command, 498 
Trace StoreQual None command, 499 
Trace Trigger command, 500-503 

and breakpoints, 353 
Trace Trigger Event command, 504-506 
Trace Trigger List command, 507 
Trace Trigger Never command, 508 
tracing background operation, 298 
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tram, memory characterization, 286 
trigger 

See trace measurement, triggers 
trom, memory characterization, 286 
type casting, 541 
type conversion, 541 

U Unknown (debugger status), 70 

unknown module in backtrace window, 141 

until macro, 586 

uP Idle (debugger status), 70 

user interfaces, 558 

user program symbols 

simulated I/O, 159 

systemio_buf, 159 
user-defined macros 

See macros 
user-defined screens 

defining, 241 

displaying, 242 

removing, 243 
user-defined windows 

defining, 241 

erasing iirformation in, 242 
removing, 243 

V variables 

breaking on access, 31 

displaying, 27 

displaying address of, 30 

initiaUzing, 199 

macros, 205 

modifying, 192 
version, 72 

displaying, 138 

emulator/analyzer, 621 
view information in the active window, 129-131 
view window, description of, 138 
viewing text, 17 

W W indicator character, 71 

what's new in this version, 72 
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when macro, 587 

example, 353, 358-360 
while statement, 206 
widget resource 

See X resource 
Window Active command, 509-510 
Window Cursor command, 511 
Window Delete command, 512 
Window Erase command, 513 
Window New command, 514-516 
Window Resize command, 517 
Window Screen_On command, 518 
Window Toggle_View command, 519-520 
windows, 125 

active, 127 

backtrace, 102, 140-142 

breakpoint, 99 

commands, summary of, 350 

copying to file, 131 

definition, 640 

description of, 125 

displaying alternate view, 128 

error, 592 

help, 67 

journal, 42, 132 

journal file, 152 

log file, 152 

making active, 127 

monitor, 149 

moving, 239 

predefined, 125 

register, 138 

resizing, 239 

scrolUng, 17 

setting behavior of, 236 

settings, saving, 244 

stack, 126 

view, 138 

working with, 125 

X,640 

See also X windows 
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windowsjoumal, 417 
word macro, 588 
words 

changing, 196 
Working (debugger status), 70 
working directory, 640 
workstation 

HP 9000 memory needs, 622 

HP 9000 minimum performance, 622 

SPARCsystem memory needs, 624 

SPARCsystem minimum performance, 624 
write macro, 589-590 
write to ROM break, 297 

X X cUent, 246, 332 

X resource, 246, 331-342 

$XAPPLRESDIR directory, 337 
$XENVIRONMENT variable, 337 
.Xdefaults file, 336 

/usr/hp64000/lib/Xl l/HP64_schemes, 339 

app-defaults file, 336 

application-specific, 332 

class name for applications defined, 335 

class name for debugger, 249 

class name for widgets defined, 333 

command line options, 337 

commonly modified graphical interface resources, 248 

Debug.BW, 338 

Debug.Color, 338 

Debug .Input, 338 

Debug.Label, 338 

Debug.Large, 339 

Debug.Small, 339 

defined, 332 

definition, 640 

general form, 333 

instance name for applications defined, 335 
instance name for widgets defined, 333 
loading order, 336 

modifying resources, generally, 248, 341 
RESOURCE_MANAGER property, 337 
scheme file system directory, 339 
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X resource (continued) 

scheme files, debugger's graphical interface, 338 

scheme files, named, 338 

schemes, forcing interface to use certain, 340 

wildcard character, 334 

xrdb, 337 

xrm command line option, 337 
X resources 

introduction, 246 
X server, 246, 332, 640 
X windows 

definition, 640 



Certification and Warranty 



Certification 

Hewlett-Packard Company certifies that this product met its published 
specifications at the time of shipment from the factory. Hewlett-Packard further 
certifies that its calibration measurements are traceable to the United States 
National Bureau of Standards, to the extent allowed by the Bureau's calibration 
facility, and to the caUbration faciUties of other International Standards 
Organization members. 



Warranty 

This Hewlett-Packard system product is warranted against defects in materials and 
workmanship for a period of 90 days from date of installation. During the warranty 
period, HP will, at its option, either repair or replace products which prove to be 
defective. 

Warranty service of this product will be performed at Buyer's faciUty at no charge 
within HP service travel areas. Outside HP service travel areas, warranty service 
will be performed at Buyer' s facility only upon HP' s prior agreement and Buyer 
shall pay HP's round trip travel expenses. In all other cases, products must be 
retumed to a service faciUty designated by HP. 



For products returned to HP for warranty service, Buyer shall prepay shipping 
charges to HP and HP shall pay shipping charges to return the product to Buyer. 
However, Buyer shall pay aU shipping charges, duties, and taxes for products 
returned to HP from another country. HP warrants that its software and firmware 
designated by HP for use with an instrument will execute its programming 
instructions when properly installed on that instrument. HP does not warrant that 
the operation of the instrument, or software, or firmware will be uninterrupted or 
error free. 

Limitation of Warranty 

The foregoing warranty shall not apply to defects resulting from improper or 
inadequate maintenance by Buyer, Buyer-supplied software or interfacing, 
unauthorized modification or misuse, operation outside of the environment 
specifications for the product, or improper site preparation or maintenance. 

No other warranty is expressed or implied. HP specifically disclaims the 
implied warranties of merchantability and fitness for a particular purpose. 

Exclusive Remedies 

The remedies provided herein are buyer's sole and exclusive remedies. HP 
shall not be liable for any direct, indirect, special, incidental, or consequential 
damages, whether based on contract, tort, or any other legal theory. 

Product maintenance agreements and other customer assistance agreements are 
available for Hewlett-Packard products. 

For any assistance, contact your nearest Hewlett-Packard Sales and Service Office. 



